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ACCOUNT 


1-6-2 


GOTO 1-4-4 


RBR 


1-9-4 


ALGOL 


1-11-3 


GPSS 


84003900 


REDUCE 


60429800 


APEX 


76070000 


GTR 


1-7-17 


RENAME 


1-7-26 


APPEND 


1-8-5 


IF 


1-4-7 


REPLACE 


1-8-15 


ASCII 


1-4-12 


ISF 


60435700 


REQUEST 


1-7-27,10-17 


ASSIGNfttt 


1-7-2, 10-11 


ITEMIZE 


60495600 


RERUN 


1-6-14 


ATTACH 


1-8-6 


JOB 


1-5-4 


RESEQ 


1-7-29 


BASIC 


1-11-6 
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1-14-10 
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1-6-15 


BKSP 


1-7-3 


LABEL 


1-10-13 


RESTART 


1-12-2 


BLANK 


1-10-12 


LBC 


1-9-2 


RETURN 


1-7-29 


CALL 


1-4-5 


LDI 


1-6-7 


REWIND 


1-7-30 
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1-7-4 


LDSET 


60429800 


RFL 
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1-8-8 


LENGTH 


1-6-8 
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CHANGE 


1-8-10 
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1-7-31 
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1-6-2 
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1-7-19 


RTIME 
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60435700 


LIBLOAD 


60429800 


SATISFY 


60429800 


CKP 


1-12-1 


LIBRARY 


60429800 


SAVE 


1-8-16 


CLEAR 


1-7-7 


LIMITS 


1-6-8 


SCRSIM 1 1 t 


60435700 


COBOL 


1-11-8 




60435700 


SET 


1-4-6 


COBOL 5 


1-11-11 


LISTLB 


1-10-16 


SETASL 
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COMMENT 


1-6-3 
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COMMON 


1-7-7 


LOAD 
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SETID 
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SETPR 
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1-7-8 
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1-7-9 
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NOEXIT 
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SORTMRG 
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NOGO 
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1-7-38 


CSET 
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NORERUN 
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1-6-20 
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SUBMIT 


1-6-21 


DAY FILE 


1-6-3 
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1-8-12 
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1-6-25 


DEFINE 


1-8-11 


ONEXIT 


1-6-13 


SUMMARY 


1-6-25 


DISPLAY 


1-4-6 


ONSW 


1-6-14 


SWITCH 


1-6-26 


DISPOSE 


1-7-14 
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1-14-4 


SYSEDITttt 


60435700 


DMD 


1-9-2 
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TDUMP 


1-7-39 


DMP 


1-9-1 


OUT 


1-7-24 


UNLOAD 


1-7-40 


DOCMENT 


1-7-15 
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1-8-13 
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EDIT 


1-14-1 
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1-7-41 
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1-7-42 
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PURGALL 


1-8-14 


WRITEF 


1-7-42 


GET 


1-8-12 


PURGE 


1-8-15 


WRITER 


1-7-42 



t Reference to a page number indicates the statement is described in this manual; 
a manual publication number means the statement is described in that manual. 
tt For system origin jobs only. 
1 1 tFor system origin jobs or users with system origin privileges and DEBUG mode on 
on at the console. 
t 1 1 f Some features of this statement require system origin privileges. 
1 1 1 1 |For system origin jobs or users with system origin privileges and ENGINEERING 
mode on at the console. 
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PREFACE 



The Network Operating System (NOS) was developed by Control Data Corporation to provide 
network capabilities for time-sharing and transaction processing, in addition to local and 
remote batch processing, on CONTROL DATA® CYBER 170 Series, Models 172, 173, 174, 
and 175 Computer Systems, CONTROL DATA® CYBER 70 Series, Models 71, 72, 73, and 74 | 
Computer Systems, and CONTROL DATA® 6000 Series Computer Systems. 

This manual describes the external features of NOS 1.2 for the batch user. Information in | 

this manual should be useful to those who use the programs and utilities supplied with the 
system and those who wish to write their own. The manual is contained in two volumes to 
separate information pertaining primarily to the applications programmer from that per- | 

taining to the applications COMPASS programmer. I 

Volume 1 (publication no. 60435400) contains information for the applications programmer. 
This includes general information about files, job flow and execution, control statement 
processing, and an extensive discussion on control statements. 

Volume 2 (publication no. 60445300) contains information for those who write system or 
assembly language programs for use with NOS. It is primarily intended for the applica- I 

tions COMPASS programmer; however, several portions contain information for users ■ 

of higher level languages. For reference, the table of contents of volume 2 follows the 
table of contents of this volume. 

Throughout this manual, cross-references to the NOS Reference Manual, volume 2 are in 
the form, "refer to section (or appendix) n, volume 2". If volume 2 is not stipulated, the 
reference is to this manual. 

This manual does not contain a description of NOS system operation, detailed descriptions 
of the software product set available under NOS, or descriptions of the time-sharing 
commands. 

The user is assumed to be familiar with CDC computer systems and with operating systems 
in general. For further information concerning CDC CYBER 170, CDC CYBER 70, and 
6000 Series Computer Systems, the NOS time-sharing system, and the products supported 
by NOS, consult the following manuals. 



Control Data Publication 

CYBER 170 Computer Systems Reference Manual 
CYBER 70/Model 71 Computer System Reference Manual 
CYBER 70/Model 72 Computer System Reference Manual 
CYBER 70 /Model 73 Computer System Reference Manual 
CYBER 70/Model 74 Computer System Reference Manual 
6400/6500/6600 Computer Systems Reference Manual 



Publication No. 

60420000 
60453300 
60347000 
60347200 
60347400 
60100000 
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Control Data Publication 

NQS General Information Manual 

NOS Installation Handbook 

NOS Operator's Guide 

NOS Application Programmer's Instant 

NOS System Programmer's Instant 

NOS Time-Sharing User's Reference Manual 

NOS Time-Sharing User's Guide 

NOS Terminal User's Instant Manual 

NOS Text Editor Reference Manual 

NOS Export/Import Reference Manual 

TRANEX 1 Reference Manual 

TRANEX 1/TAF 1 User's Guide 

TAF 1 Reference Manual 

TAF 1 Data Manager Reference Manual 

NOS Modify Reference Manual 

NOS Modify Instant 

Update Reference Manual 

NAM Reference Manual 

Network Definition Languages Reference Manual 

Network Administrator and Operator Facility 
Reference Manual 

BASIC 3 Reference Manual 

APL -'CYBER Reference Manual 

APL 2.0 Reference Manual 

FORTRAN Extended 4 Reference Manual 

COBOL 4 Reference Manual 

COBOL 5 Reference Manual 

ALGOL 4 Reference Manual 

Sort/Merge 4 Reference Manual 

CYBER Record Manager 1 Reference Manual 

CYBER Loader 1 Reference Manual 

FORM 1 Reference Manual 

COMPASS 3 Reference Manual 

SYMPL 1 Reference Manual 

CDCS 1 Reference Manual 

Data Base Utilities 1 Reference Manual 

Query Update 2 Reference Manual 



Publication No. 
60435900 
60435700 
60435600 
60436000 
60449200 
60435500 
60436400 
60435800 
60436100 
60436200 
60407900 
60436500 
60453000 
60453100 
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60450200 
60449900 
60499500 
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60495700 
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60492600 
60496400 
60498700 
60498800 
60384900 
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DDL 1 Reference Manual 

Query Update 3 Reference Manual 

DDL 2 Reference Manual 

SIMSCRIPT 3 Reference Manual 

SIMULA 1 Reference Manual 

APEX III 1 Reference Manual 

APT IV 2 Reference Manual 

LCGT/IGS 1 Reference Manual 

GPSS V/6000 1 General Information Manual 

PERT/Time 1 Reference Manual 

Total Universal 1 Reference Manual 

8-Bit Subroutines 1 Reference Manual 

Math Science Library 1 Reference Manual 

Common Utilities Reference Manual 

Application Installation Handbook 

On-Line Maintenance Software Reference Manual 

RBF Reference Manual 



Publication No. 
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60499300 
17322800 
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This product is intended for use only as described in this document. Control 
Data cannot be responsible for the proper functioning of undescribed features 
or undefined parameters. 
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SYSTEM DESCRIPTION 



The CDC CYBER 170 Series, Models 172, 173, 174, and 175 Computer Systems, CDC 
CYBER 70 Series, Models 71, 72, 73, and 74 Computer Systems, and 6000 Series Computer | 
Systems consist of four logical hardware components. They are: 

• Central processor unit 

• Central memory 

• Peripheral processor units 

• Associated peripheral equipment 

These hardware elements are controlled and coordinated by two basic levels of software, 
the system software and user programs. This section describes briefly these hardware 
and software elements and their relationship within the Network Operating System (NOS). 



CENTRAL PROCESSOR UNIT 

The central processor unit (CPU) performs computational tasks but has no input/output 
(I/O) capability. It communicates with the external world through central memory. 
Under NOS, the CPU is used to assemble, compile, and execute user programs and to 
perform several system functions and utilities. 

The CDC CYBER 170 Series, CDC CYBER 70 Series, and 6000 Series Computer Sys- 
tems provide two types of central processors. However, the programmer need be con- 
cerned only with the distinction between the two types when writing COMPASS programs. 
Certain instructions, if properly arranged, may be executed simultaneously by the CDC 
CYBER 170/Model 175 CPU, CDC CYBER 70/Model 74 CPU, and the 6600 CPU. For | 
more information about CDC CYBER 170, CDC CYBER 70, and 6000 systems refer to 
the hardware reference manuals listed in the preface. 

CDC CYBER 170 and CDC CYBER 70 series computers are equipped with a central 
exchange jump/monitor exchange jump (CEJ/MEJ) feature. This feature enables the 
system to switch control between the system monitor and a user program. CEJ/MEJ is 
an option on 6000 series computers. It should be used when available to improve job 
performance (refer to section 2 of volume 2). | 

CENTRAL MEMORY 

Under NOS, central memory (CM) is used for three basic purposes. 

• To hold instructions to be executed by the CPU 

• To hold data to be manipulated by the CPU 

• To buffer data to and from peripheral processors 
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NOS supports the following standard CM sizes. 

6000 and CDC CYBER 70 - 32K, 49K, 65K, 98K, and 13 IK 
CDC CYBER 170 - 32K, 49K, 65K, 98K, 13 IK, 198K, and 262K 

Several programs can reside in CM simultaneously in hardware protected areas called 
control points. The fact that these control point areas are hardware-protected means 
that a program cannot reference an address outside its field length. NOS supports a 
maximum of 273 control points. Each control point may use no more than 377700 8 
CM words. The user need be concerned only with the memory assigned to his own 
control point. The system assigns the CPU to the control points requiring CPU activity. 
Normally, the assignment of the CPU is switched rapidly between the control points to 
allow all programs in memory to execute. The exact amount of time allowed for each 
control point depends on system activity and system parameters. Thus, a job may 
take more real-time to complete at one time than at another. The user has no control 
over this switching process. 

I The user program communicates with the system by placing requests in address 1 (RA+1) of 
the control point (described in section 2 of volume 2). RA is the reference address that 
specifies the beginning of the user's control point memory area. 

When a user program completes, aborts, or is rolled out, the control point is released 
and made available to another program. 

CENTRAL MEMORY RESIDENT 

A portion of CM is reserved for system use. This area is, in effect, a control point 
with special privileges. This area is called central memory resident (CMR). It con- 
tains system tables and directories as well as the CPU portion of the system monitor 
(CPUMTR). 

Figure 1-1-1 illustrates the layout of CM and shows the relationship between CMR and the 
user control points. 

EXTENDED CORE STORAGE 

Extended core storage (ECS), a second, slower form of memory, is also available. 
NOS treats ECS as a mass storage device; it can be used: 

• For storing frequently accessed data. Refer to ASSIGN Statement in section 7, 
and Permanent File Control Statements in section 8. 

• As an alternate system device for storing copies of ABS, OVL, and PP type 
routines. Refer to the SYSEDIT control statement in the installation handbook 
for further information. 

The FORTRAN and COMPASS statements for ECS data storage /retrieval are not sup- 
ported by NOS. 



PERIPHERAL PROCESSOR UNITS 

The peripheral processor units (PPUs) are small processors that provide communication 
paths between the central processor and individual peripheral equipment. NOS supports 
the 10, 14, 17, and 20 PPU configurations of CDC CYBER 170/Models 173, 174, and 
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175 (the Model 172 supports 10 PPUs only) and CDC CYBER 70/Models 71, 72, 73, and 74. | 
The 7, 8, 9, 10, and 20 PPU configurations are supported for 6000 series computers. 
A peripheral processor can: 

• Read and write CM 

• Read and write ECS indirectly via CM or directly via the distributive data 
path (DDP) 

• Transmit data to and receive data from peripheral devices using the data 
channels 

The peripheral processors also perform those system control functions that are better 
handled by a PPU than by the central processor. 

For further information about PPUs, refer to the appropriate system hardware reference 
manual listed in the preface. 
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PERIPHERAL HARDWARE 

The system peripheral hardware varies from installation to installation but usually in- 
cludes card readers and punches, line printers, mass storage devices, and magnetic 
tape units. The following equipment is supported by NOS. 

405 Card Reader 

415 Card Punch 

512 and 580 Line Printers 

841 Multiple Disk Drive 

844-21 Disk Storage Subsystem 

844-41 Disk Storage Subsystem 

844-44 Disk Storage Subsystem 

Extended Core Storage 

657, 659, 667, and 669 Magnetic Tape Units 

6671 Multiplexers for communication with 200 User Terminals and 731-12/732-12 
Remote Batch Terminals 

6671 or 6676 Multiplexers for communication with interactive terminals 

2 550 Host Communication Processor 

The user need be concerned with these devices only to the degree that they affect the 
format of data being transferred in the system. 

SYSTEM SOFTWARE 

The system consists of the group of CPU and PPU programs that control the flow of 
user programs and satisfy any special requests that these programs may make. These 
special requests include such functions as resource allocation requests and I/O 
requests. 

USER PROGRAMS 

A user program is a group of CPU instructions defined by a user to perform a certain 
task or calculate a specific result. A user program may be written in a language at 
any of three levels. 

• Compiler languages provide the user with a language suited to his particular 
needs. The program statements are translated by the appropriate compiler 
(FORTRAN, COBOL, ALGOL, etc.) that generates assembler language or 
machine language instructions. Programs written in compiler languages are 
usually machine- independent. 

• Assembler languages provide a one-to-one relationship between instructions and 
machine operation. Mnemonics are provided for each instruction. These 
languages are normally used by advanced programmers because they are 
machine-dependent. Most of the NOS system is written in COMPASS, the 
assembler language of the CDC CYBER 170, CDC CYBER 70, and 6000 series 
computers. 

• Hardware instructions are interpreted directly by the computer, and therefore, 
require no interpretation by a compiler or assembler. Each hardware instruc- 
tion is a binary number. The programmer is rarely concerned with instruc- 
tions written at this level. The exception is when program debugging requires 
that the user scan memory dumps. 

1-1-4 60435400 C 



FILES 



A file is the largest collection of information addressable by name. It begins with a 
beginning-of- information (BOI), an indicator which precedes all data in the file. A file 
consists of one or more logical records of information. A logical record is a group of 
related words or characters, of fixed or variable length, which is independent of its 
physical environment. 

The end of a logical record is the end-of-record (EOR). The end of a logical file is 
the end-of-file (EOF), the end -of- information (EOI), or both. If both, the EOF pre- 
cedes the EOI. An EOI is the last physical item of information on a file. Because of 
this EOF/EOI concept, a file may actually be a multifile file. For example: 

(BOI)data (EOR) data (EOR)(EOF) data (EOR)(EOF)(EOI) 

File names are 1 to 7 alphanumeric characters, t 

Examples: 

A 123 TAPE v 1A2B COMPILE 

LOGICAL/PHYSICAL FILE STRUCTURE 

The actual structure of the BOI, EOR, EOF, and EOI indicators depends on the device 
on which the information, is stored. 

The user defines the logical format of a mass storage or magnetic tape file when he 
issues control statements or language specifications to create the file. Once a file is 
created, it can be transferred from one storage medium to another without affecting its 
logical format. 

To take advantage of the physical characteristics of the medium on which a file is to be 
stored, the system converts all user- defined logical file structures into a system- defined 
physical file structure. In general, for higher-level language users, this conversion 
process and the resulting physical file format are transparent. All file- related control 
statements and language specifications transfer data or position a file according to its 
logical definition. COMPASS users, on the other hand, have the option of reading, 
writing, or positioning a file according to its logical or physical format. 

The basis of all physical file structures is the physical record unit (PRU). The size of 
a PRU depends on the storage medium used. 



t The product set modules (section 11) do not support file names that begin with a numeric. | 
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MASS STORAGE DEVICE FILE STRUCTURE 

All data stored on mass storage devicest is written in 64 CM word PRUs. A logical 
record consists of one or more of these PRUs. The last PRU of a mass storage logi- 
cal record must be a short (less than 64 CM words) or zero-length PRU. 

A BOI for a mass storage file is the disk address for the file listed in the file name 
table (FNT). An EOR is a PRU containing less than 64 words and having a link to the 
next PRU in the file. An EOF for a mass storage file is a zero-length PRU (that is, 
a PRU containing no data) with a special link to the next PRU in the file. An EOI is 
a zero-length PRU with no forward link. The absence of a link signifies the EOI. 

MAGNETIC TAPE FILE STRUCTURE 

The operating system uses standard 7- or 9-track, 1/2-inch magnetic tape. BOI on 
magnetic tape is the load point. The definition of PRUs and of the EOR, EOF, and EOI 
Sdfcators varies according to the format in which the data was recorded. Any of the 

fflimatfl can be specified: external (X). blocked ®;l^eiV^to 
system internal (SI), stranger (S), long block stranger tape (L), and foreign (F), Refer to 
section 10 for a description of each of these formats. 



PUNCH FILE STRUCTURE 

Because the physical characteristics of cards define the data, cards do not have a PRU 
size as previously defined. Refer to appendix F for the conversion procedures used 
for the various types of punch cards. The logical format of the file is indicated as 
follows: 

The first card in the deck is the BOI 

A 7/8/9 punch in column 1 represents an EOR 

A 6/7/9 punch in column 1 represents an EOF 

• A 6/7/8/9 punch in column 1 represents the EOI 

Thus, a deck can consist of many files which can consist of many records, as illustrated 
in figure 1-2-1. 



EOR 



BOI 




Figure 1-2-1. Sample Card File Structure 
t ECS files are allocated in the same manner as all mass storage files. 
1-2-2 
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FILE TYPES 

Active files in the system are classified by their file type, Whenever a file is active, 
one or more entries are made in the file name table (FNT). The FNT entry and the 
file status table (FST) entry comprise a two-word description of the file. These two 
entries contain the name of the file, the device on which the file resides, the file type, 
the current position, and the current status. All system tasks involving a file use 
this two-word entry for control. 

In each of the following descriptions, the file type and its mnemonic (such as INFT) 
which the system uses internally for file classification are listed. 

QUEUE FILES 

Five types of files are defined as queue files. They are categorized as such because 
of the kinds of information they contain and the manner in which the system processes 
them. Queue files always reside on mass storage. When a queue file is ready to be 
processed, the system or the user places it in a queue where it waits until the re- 
quired system resource or peripheral equipment becomes available. 

Input Files (INFT) 

Input files are the job files of the system. They contain all user -supplied control 
statements and program data. There are two ways a file can be placed in the input 
queue, directly by the system in initiating a local or remote batch job for processing 
and indirectly by a user job in submitting another job via a SUBMIT control statement, 
an LDI control statement, or a ROUTE control statement. | 

When central memory space becomes available, either because a job has completed 
or because a job in the input queue has a higher priority than that of a job being 
processed, the input file is scheduled for processing (in other words, the job is 
assigned to a control point in central memory). Refer to section 3 for a description 
of the elements of jobs and the processes of job initiation and scheduling. 

Rollout Files (ROFT) 

At some stage in the processing of a job, the system or the user may determine that 
the job must be temporarily removed from central memory. When this occurs, the 
system writes all information concerning the job on a system- defined rollout file. The 
rollout file includes the contents of the job's central memory field length and the job- 
related system information from CMR. The file is read back into central memory 
when the job Is again scheduled at a control point. (Refer to Rollout Control in 
section 3. ) 

Timed/Event Rollout Files (TEFT) 

A timed/event rollout file is similar to an ROFT file in that it contains all the infor- 
mation concerning a job temporarily removed from central memory. A TEFT file, 
however, is rolled back into central memory only when a specified event has occurred 
(such as a file is no longer busy) or a specified time period has elapsed. 
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A job may be rolled out on a TEFT file as a result of system or user action. The 
system uses a timed/ event file if a job issues certain requests for a file or device 
that cannot be immediately honored. The COMPASS programmer can use the ROLLOUT 
macro to roll out his job subject to specified time and/or event dependencies. 

Print Files (PRFT) 

A print file contains data the user wishes to have printed during his job or upon job 
completion. The system-assigned name for print files is OUTPUT. t OUTPUT is 
placed in the print queue either by the system when the job completes or by the user 
via an OUT control statement. The user can also utilize a ROUTE or DISPOSE control 
statement. 

Once a file enters the print queue, it is processed by the local or remote batch printer 
processor. Then, when a printer becomes available, the PRFT file with the highest 
priority is printed. 

Most system utility reports are written on OUTPUT unless the user specifies an 
alternate file. OUTPUT has no special internal format. Refer to appendix F for a 
description of conversion methods and printer control characters and to appendix D for 
a description of job output information. 

Punch Files (PHFT) 

Punch files contain data that the user wishes to have punched on cards during his job 
or upon job completion. The system- assigned names for punch files are: 

PUNCH Contains Hollerith punch output 

PUNCHB Contains binary punch output 

P8 Contains 80 -column absolute binary punch output 

These files are released to the punch queue when the job completes. In addition, the 
user can utilize an OUT, ROUTE, or DISPOSE control statement in the same manner 
as described for PRFT files to place a file in the punch queue. 

Refer to appendix F for a description of the format of the PUNCH, PUNCHB, and P8 
files. 

SPECIAL FILES 

Of the five special files, the first two described (local and direct access permanent 
files) are general-purpose, and the remaining three (library, system, and primary 
terminal) are special-purpose. 

Local Files (LOFT) 

All scratch and working files are designated as local files. The user can create a 
local file in three ways; he can: 

1. Implicitly create a local file by making the first reference to it in one of the 
COPY control statements, any read or write language specification, or an OPEN 



T For time- sharing jobs, the name OUTPUT has special meaning. Refer to section 12., 
volume 2, and to the Time-Sharing User's Reference Manual. 
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macro. Local files created in this manner always reside on mass storage. 

2. Create a local file by preceding any COPY statements, read or write specifi- 
cations, or OPEN macros with an explicit control statement or macro file 
definition. The ASSIGN control statement or the REQUEST control statement 
or macro assigns a local file to mass storage or magnetic tape. The LABEL 
control statement or macro assigns a local file to magnetic tape. 

3. Use a GET control statement or macro to generate a local mass storage copy of an 
existing indirect access permanent file. For a description of indirect access 
permanent files, refer to Permanent Files in this section. 

Unless the user includes a control statement or macro to change a local file to another type 
of file, it is released upon job completion. 

Direct Access Permanent Files (PMFTJ 

A direct access permanent file is the type of permanent file that can be accessed 
directly rather than through the use of a working copy. The user creates a direct 
access file with the DEFINE control statement or macro. Once the file is created, the 
originator or anyone else to whom the originator has given permission can assign the 
file to his job with an ATTACH control statement or macro. The file remains in the system 
until the originator removes the file with a PURGALL control statement, or the originator 
or any other user with the necessary permission removes the file with a PURGE control 
statement or macro. 

For further information about direct access permanent files and their relationship to 
indirect access permanent files, refer to Permanent Files in this section. 

Library Files (LIFT) 

A library file is a read-only file that can be accessed by several users. A user must 
be validated to access/create library files. Note that this type of file should not be 
confused with system library programs or public permanent files (user number LIBRARY). 

A library file is created by performing the following steps. 

1. Create a local file lfn. 

2. Enter the following directives as control statements or macros. 

LOCK(lfn) 
COMMON(lfn) 

If a user wishes to read this file and knows the file name, either the COMMON control 
statement or ASSIGN macro is entered. When either of these functions is performed, 
an FNT entry representing this file as a library type file is created. 

A library file cannot be removed from the system once it has been created except by a 
deadstart. Library files are not retained on initial (level 0) deadstart. They are 
retained on level 1 or 2 deadstart if a system checkpoint was done after their creation. 
They are always retained after a level 3 deadstart. | 

For a description of the relationship between LIFT files and other libraries and library 
files, refer to Libraries in this section. 
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System Files (SYFT) 

The system uses SYFT files for retaining special system information. SYFT files 
always reside on mass storage. Although the COMPASS programmer who is validated 
to create system files can do so with an ESYF macro, only special system programs 
can access them. Once a system file is created, no user including the originator can 
remove it. However, system files are lost at system deadstart unless the operator 
recovers them. 

Primary Terminal Files (PTFT) 

The primary file is the main working file for the user. Of several files which may 
be local to his job, the user may designate one file to be the primary file by using 
a NEW or PRIMARY statement. (A copy of an indirect access file may be retrieved 
and made a primary file using the OLD statement. ) This becomes the default file if 
a file name is not specified. Only one primary file is available to the user at a time. 

QUEUED FILE MANAGEMENT 

Queued file management routes all output generated by a job to the remote batch ter- 
minal where the job was created. This is implemented by assigning a unique terminal 
identification code (TID) every time a remote batch terminal is logged in. (The TID 
can be the user index associated with the user number when logging in. ) 

When a job from a remote batch terminal is put into the input queue, the TID is asso- 
ciated with the job input file. This TID is transferred to any print or punch file that 
is generated by job processing. At job termination, the system uses the TID to route 
the output file to the remote batch terminal of job origin. In a similar way, a central 
site card reader may be assigned an identification number (ID) to route batch output 
files to a line printer or card punch with the same ID. 

The user can route output files to a particular device rather than accept the TID de- 
fault. The particular device can be specified on the basis of device type (printer 
model, punch format, etc. ), external characteristics (ASCII, 029, etc. ), or forms. 
code (requires special form selection). Refer to ROUTE control statement, section 7 
for a description of file routing. 

RESERVED FILE NAMES 

Several file names are reserved for system use or have special significance to the 
system. These reserved names protect the user from accidentally destroying some of 
his own files. The message 

RESERVED FILE NAME. 

indicates that the user has attempted to use one of these files. 

The reserved file names are: 

INPUT SCR 

OUTPUT SCR1 

PUNCH SCR2 

PUNCHB SCR3 

P8 SCR4 
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A number of the product set members, such as the COMPASS assembler, use other 
scratch files in addition to those listed. 

Since system integrity does not depend on preventing the use of these reserved file 
names, an attempt is not always made to prevent their use. 

PERMANENT FILES 

The user can create, retain, and access files which are available until he specifically 
decides to remove them from the system. These files are called permanent files. 
There are two types of permanent files. 

• Direct access permanent files are accessed using normal I/O procedures, 
including random read and write requests. Direct access permanent files 
are allocated in large blocks;f thus, they are generally used as large data 
base files. Direct access files have a write interlock. This means that if 
one user has attached the file in write mode, it cannot be attached by an- 
other user. Likewise, if a user wishes to attach the file in write mode, he 
must wait until all current users have completed using the file. The user 
should also note that because data is written directly on the file rather than 
on a working file, care must be taken when modifying a direct access file. 

The maximum size of a direct access file is determined either by the DS validation 
parameter described in the LIMITS control statement, section 6, or if no DS re- 
striction is imposed, by the device limitations described in appendix E. 

# Indirect access permanent files are accessed by using a working copy of the 
file as a local file attached to the user's job. This working copy is obtained 
with the OLD control statement or the GET control statement or macro. I 
If the user wishes the working copy to remain permanent after the file has I 
been altered, the SAVE or REPLACE functions must be issued. Indirect 
access files are allocated in blocks of 64 central memory words (640 char- 
acters). Because of this smaller block size and the convenience of a work- 
ing copy, the indirect access file is generally the method used to create a 
small permanent file that does not require a write interlock. 

The maximum size of an indirect access file is determined either by the FS 
validation parameter described in the LIMITS control statement, section 6, 
or if no FS restriction is imposed, by the device limitations described in 
appendix E. 

User access of permanent files is based on the user number entered with the USER control I 

statement. This user number is a 1- to 7-character value which represents a specific I 

catalog in the permanent file system. Unless otherwise specified by an optional (alternate) 
user number, all permanent file requests are made to this catalog. 

User numbers that contain asterisks represent users with automatic read-only permission 
to files in catalogs of other users. The user number must match the alternate user 
number in all characters not containing asterisks. For example, the user with the user 
number *AB*DE* can access the catalogs of the following users. 

UABCDEF 
UABDDEE 
MABCDE1 
MAB1DE3 



| Refer to Permanent File Device Statistics, appendix E. 
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DEVICE RESIDENCE 

For most file operations, the user need not be concerned about the specific device on 
which his file resides. However, under certain circumstances the user may wish to 
override the system default device residence for local or permanent files. 

With the ASSIGN control statement, any user who has the necessary validation can assign a 
local file to either a specific magnetic tape or mass storage device or to one of a type 
of magnetic tape or mass storage devices. 

Every permanent file the user creates resides either in his family of permanent file de- 
vices or on an auxiliary device. Unless the user specifies otherwise, all permanent 
files are saved in his family. 

A family consists of 1 through 63 mass storage devices. Within a family, each user 
has a master device that contains his permanent file catalog, all indirect access files, 
and some or all of his direct access files. 

Normally a system has only one family of permanent file devices. However, because 
families are interchangeable between NOS systems, several families may be active on 
one system or a system may be in multimainframe mode. For example, consider an 
installation with two systems, A and B. System A provides backup service to system 
B. If system A failed, its family of permanent file devices could be introduced into 
system B without interrupting current operations on system B. 

The user identifies his family by supplying a 1- to 7-character family name. The family 
name is included on the USER statement in batch jobs and is entered during login in 
time- sharing jobs. If only one family is active or if another family has been introduced 
into the user's normal system, he may but need not supply his family name. When the 
family name is omitted, the system uses the system default family name. If the user's 
family has been introduced into another system, he must supply his family name. 

If the user chooses to save his files on family devices, he has the option of either using the 
system default device type or of specifying another type of permanent file device. 

An auxiliary device is a supplement to the mass storage provided by family devices. 
It is identified by a 1- to 7-character pack name. An auxiliary device is not necessarily 
a disk pack that can be physically removed as the pack name implies. Rather, an 
auxiliary device can be any mass storage device supported by the system and defined 
as such by the installation. Each auxiliary device is a self-contained permanent file 
device; all direct and indirect access files represented by the catalogs on the device 
reside on the device. Auxiliary devices may be defined as public or private. Anyone 
permitted to use auxiliary devices who supplies the appropriate pack name can create, 
replace, and access files on a public device. Only one user, the owner, can create 
and replace files on a private auxiliary device, but others may access those files as 
permitted by the owner. 
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ACCESSING FILES 

The two methods used to access files attached to a job are sequential and random access. 
Any file can be accessed sequentially; however, only mass storage files can be accessed 
randomly, f I 

To read a file randomly, the system reads a portion of the file without reading all infor- 
mation in the file, from the current position to the desired position. Any mass storage 
file can be read randomly if the user knows which relative PRU (that is, which PRU in 
relation to the BOD he wishes to read. The desired PRU can be read by placing the PRU 
number in the file's communication area (FET) and making the proper I/O requests 
(refer to section 3, volume 2). 

Several methods of random processing exist. The specific method depends on the lan- 
guage being used; however, in all cases, the following points apply. 

• Most random I/O operations require a directory or index that contains the 
relative PRUs of records in the file. 

• An EOR or EOF I/O operation transfers one PRU for the EOR or EOF. 

• When randomly rewriting data within a file, the user must take care to ensure 
that data following the area he wishes to write is not destroyed. 

Figure 1-2-2 illustrates a typical example of the structure of a random access file. 

READING FILES 

To read record 3 sequentially, the program rewinds the file to BOI, reads the file, 
and counts the number of EORs. System utilities and macros can be used to skip the 
records; however, the primary consideration is that the data must be read to determine 
where record 3 begins. Once this is determined, record 3 can be read. 

If a directory exists for this file, the only requirement is that the random address of 
record 3 be obtained from the directory and placed in the FET. The proper random 
read requests can then be issued. To perform this random read on record 3, the following 
steps are required. 

• Skip to the EOI. This is done by the system without reading the entire file. 

• Backspace two logical records (one record for the EOF and one for the 
directory). The system must read both records to perform this operation. 

• Read the directory to obtain the random address to be placed in the FET. 



NOTE 



The EOF may or may not be used at the end of this 
file. The language and methods used to build the di- 
rectory determine whether an EOF is used. 

In summary, to access record 3 sequentially, four PRUs must be read. To access the 
record randomly, only three PRUs are read: two PRUs to position for the directory 
and one PRU to read the directory. 

For additional random accesses to any record in the file, it is not necessary to access 
the directory again if it remains in central memory. 



f Record Manager random files are treated sequentially by the operating system. 
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The directory can be built 
in any format. This is a 
typical example. 
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Figure 1-2-2. Sample Random Access File Format 

Each directory entry contains the record name, the first PRU of the record (random 
address), and the record length. The directory can be placed anywhere in the file. 
The only requirement is that those users who wish to access the file randomly know 
where to position the file in order to read the directory. However, the directory 
usually precedes the EOF /EOI. 
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WRITING FILES 

After reading and modifying record 3 of the sample file, the user may wish to rewrite 
the record in the file. If the modifications have not changed the number of PRUs re- 
quired, a write operation can be used to replace the existing record with the modified 
record. This write operation must be issued as a random I/O operation. (Refer to 
section 3, volume 2 for a complete description of the method. ) However, if the 
modifications have changed the number of PRUs required, data following the record 
being written is lost. For example, the size of record 3 in the sample file is 74 
words or two PRUs. A maximum of 53 words can be added to the record without 
requiring an additional PRU and destroying data. If a random write request that adds 
53 words to record 3 is issued, the file has the following format. 



record 3 



Word count 


= 


4 


Word count 


= 64 


5 


Word count 


= 63 


6 


Word count 


= 64 


7 


8 


9 



EOF 



EOR 



This operation is called a rewrite in place. If the write is issued as a nonrandom write 
operation, the file has the following format. 



record 3 * 



Word count 


= 


4 


Word count 


= 64 


5 


Word count 


= 63 


6 


7 



EOR 



EOI 



All data following the inserted data is destroyed. If the word count for record 3 is 
increased to 138, the file has the following format. 
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record 3 



Word count : 


= 


4 


Word count : 


= 64 


5 


Word count : 


= 64 


6 


Word count : 


= 10 


7 


8 


9 



EOR 



EOR 



PRU 7 is destroyed by the write operation. To properly rewrite record 3 without de- 
stroying the contents of PRU 7, the user should issue a write request at the end of the 
file and alter the directory to reflect the change. Figure 1-2-3 illustrates the updated 
file containing the new directory and the 138-word modified record 3 written at 'the 
end of the file. 



LIBRARIES 

The term library can be used in four ways in the system. The following paragraphs define 
the various types of libraries and the methods, if any, by which the user accesses them. 

• System library. The system library consists of the assembled routines that com- 
prise the operating system and its associated product set. System routines may 
reside in central memory, mass storage, or ECS. The user accesses the 
system library indirectly when a system routine is executed in response to a 
control statement or macro call. A complete copy of the system library is saved 
on a read-only file named SYSTEM. Refer to the CATALOG control 
statement in section 7 for a partial list of the system library routines. 

• Program library. A program library is a group of source deck images saved 
on a program library file in compressed format. There are two system-de- 
fined program libraries, OPL and OLDPL. O PL contains operating system 
routines saved and maintained in Modify format via the MODIFY control state- 
ment. OLDPL contains product set routines saved and maintained in Update 
format via the UPDATE control statement. In addition, the programmer can 
use a MODIFY or UPDATE control statement to create and edit his own pro- 
gram library. 

• User library. Before a user's compiled program can be executed, all external 
references must be satisfied. The loader satisfies externals by searching 
user libraries. A user library is a group of compiled or assembled object 
time routines saved on a user library file. There are three types of user 
library files: user-generated, product set, and system. 
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BOI 
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Note that the record 3 
pointer in the directory 
has been updated. 



EOF 

EOI 



Figure 1-2-3. Modified Sample Random Access File 

Appendix B, volume 2 contains examples of COMPASS programs that create, read, 
and write a random file. 
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User-generated libraries are created with the LIBGEN control statement and 
can be specified on LIBRARY and/or LDSET control statements. Refer to the 
Loader Reference Manual for further information. Product set libraries re- 
side as ULIB type records on the system library. They are listed in section 
11. If some externals remain unsatisfied after searching these libraries, the 
loader searches the system default user library SYSLIB, which also resides 
as a ULIB record on the system library. 

User number LIBRARY. An installation can save under the user number 
LIBRARY permanent mass storage files containing programs or text of general 
interest (such as application programs and procedure files). 
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JOB FLOW AND EXECUTION 



A job consists of a file of statement images grouped into several records. The first 
logical record contains the control statements that specify the job processing require- 
ments. Each control statement is an individual job step. Every job begins with a job 
statement and ends with an EOI. All other control statements directly follow the job 
statement. The end of the control statements is marked by an EOR, EOF, or an EOI. 
Figure 1-3-1 illustrates a basic job deck. 
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Figure 1-3-1. Basic Job Deck 
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Figure 1-3-2 illustrates a COMPASS source deck that produces the object code and a 
listing and executes the binary file using the input data supplied. 
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PROGRAM 
RECORD 



CONTROL 
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RECORD 




Figure 1-3-2. COMPASS Assemble and Execute Deck 
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Figure 1-3-3 
punched files 
record. 



illustrates a COMPASS' deck that assembles the program, produces binary 
of each subprogram, and executes the object code of the first program 
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Figure 1-3-3. COMPASS Assemble, Execute, and Punch Binary Deck 
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Figures 1-3-4 and 1-3-5 illustrate examples of FORTRAN source decks used for 
computation and user output. 
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Figure 1-3-4. FORTRAN Compile and Execute Deck 
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DATA DECK 



BINARY DECK 



SOURCE DECK 



Figure 1-3-5. FORTRAN Load and Run Deck 
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JOB INITIATION 

When a job enters the system, the system determines the job origin type. The job 
origin type identifies the means by which the job is entered into the system. It is 
also used to identify the job while it remains in the system. The job origin type is 
used by the system to control job activity and to aid in directing the job through the 
system. It also determines the way the job exits from the system. 

Jobs are initiated by: 

Reading a card deck in through a card reader, either from a local or a re- 
mote batch reader. 

Logging into a time -sharing terminal. 

Using the available load utilities (refer to the LDI control statement, section 6). 

Using the SUBMIT control statement from a job already in the system (refer, to 
the SUBMIT control statement, section 6). 

Using the ROUTE control statement from a job already in the system (refer 
to the ROUTE control statement, section 7). 

The first two methods of initiation set the job origin type to indicate the method by 
which the jobs are entered. When using the SUBMIT or ROUTE control statement, a 
parameter is entered with the command specifying the origin type. 



JOB ORIGIN TYPES 

If the job originates from the system console, the job is assigned system origin type 
(SYOT). If the job is a time -sharing job and enters through the time-sharing executive, 
it is given time-sharing origin type (TXOT). If the job enters the system through the 
local card reader, it is a batch origin type (BCOT) job. A job coming into the system 
from remote batch is entered into the system by the Export/Import package or the 
Remote Batch Facility (RBF) package and is assigned Export /Import origin type (EIOT). 

If validated, a user can submit jobs to the system using the SUBMIT or ROUTE con- 
trol statements. The user can also specify origin types that are different from his 
own. 

JOB NAMES 

After entering the system, the job is assigned a unique job name to prevent job name 
duplication within the system. This job name is a combination of parameters that 
describe the job; the first seven characters are the system- assigned job name; the 
eighth character indicates the job origin type. This job name precedes all messages 
issued to the system dayfile for that job. These messages include normal operating 
messages, error messages, and accounting information issued by the system. 

SYSTEM ORIGIN TYPE (SYOT) JOB NAME FORMAT 

The first four characters of a system job name are obtained from the job name entered 
or are zero-filled if fewer than four characters are entered. The next three characters 
are a unique system sequence number in the range from AAA to 999. The eighth char- 
acter is an S. For example, if the job entered is DIS. a possible job name is 
DISOAABS. 
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BATCH ORIGIN TYPE (BCOT) JOB NAME FORMAT 

The first four characters of a batch origin job name are generated from the user index 
associated with the user number supplied on the USER control statement. These four 
characters are unique to the user. The next three characters are the job sequence _ 

number. The eighth character of a batch origin job name is B. I 

TIME-SHARING AND EXPORT/IMPORT (TXOT AND EIOT) JOB NAME FORMAT 

The first four characters of these job names are generated from the user index asso- 
ciated with the user number supplied by the user when logging into the system. The 
next three characters represent the number of the terminal on which the user is logged 
in for TXOT or the system sequence number for EIOT. The eighth character is T for 
time- sharing origin jobs and E for remote batch jobs. 

All jobs entered via a SUBMIT or ROUTE control statement derive the first four char- | 
acters of their job names from the job's current user index in the same manner as 
EIOT and TXOT jobs. The last three digits are the system sequence number with the 
eighth character being either E or B, as described previously, depending on the 
parameters supplied with the SUBMIT or ROUTE statement. | 

VALIDATION 

The USER statement follows the job statement and is used to validate the user as a 
legal user (refer to USER statement, section 6). If the user is validated, a set of con- 
trol values is set in the control point area; these values are used by the system to con- 
trol all system requests. In most cases, if the user is not permitted to perform 
specific functions (such as access nonallocatable devices), his job is aborted and the 
message 

ILLEGAL USER ACCESS. 

is issued when the illegal function is attempted. 

To determine the extent of his validation, the user can issue the LIMITS command and 
receive a listing of his current validation control values. Refer to the LIMITS control 
statement in section 6 for an explanation of these values. For further information or 
to change his validation, the user should contact installation personnel. 

Each user number has a unique user index associated with it. Once a user number is 
validated, the user index is set in the control point area. The system uses this index 
to determine on which permanent file device (and where) the user's permanent files re- 
side. (Refer to part IV of the installation handbook for an explanation of the user index. ) 

ACCOUNTING 

The unit of accounting for the system is the system resource unit (SRU). The SRU is 
a composite value of central processor time, I/O activity, and memory usage. SRU 
operations are initiated at the beginning of a job and reinitiated whenever another 
CHARGE control statement is encountered. SRU information includes: 



• 



Central processor time 
Mass storage activity 
Magnetic tape activity 
Permanent file activity 
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• SRU value 

• Application account charges t 

This information is written to the user's dayfile at the end of the job or whenever a 
CHARGE statement is processed. The user may request SRU information to be written 

I to his output file at any time during his job by issuing the ENQUIRE or SUMMARY con- 
trol- statement. The format of SRU information written in the dayfile is given under 
Job Completion in this section. 

JOB SCHEDULING 

When a job enters the system, it is placed in the input queue on mass storage, where 
it waits for the required system resources to become available. The job is assigned 
an input queue priority depending on its origin. The system priorities are system-de- 
fined and can be altered only by the system operator. The job queue priority is 
advanced as the job waits in the queue. The priority ages to a system-defined limit. 
The job scheduler periodically scans the queues and active jobs to determine whether 
action is necessary to ensure that the highest priority jobs are being serviced. This 
action may include rolling out low priority jobs or rolling in higher priority jobs. The 
job scheduler is also activated to analyze the system status whenever the status of the 
system changes (for example, when the field length of a job is released, a job enters 
a queue, or a job completes). Because of this automatic scheduling and analysis of 
system status changes, a user can increase system performance by releasing memory 
when all of the assigned memory is not required. 

Once a job is brought to a control point, normal control statement processing begins. The 
general flow of the control statement processing is illustrated in figure 1-5-1. 

JOB CONTROL 

I While a job is at the control point, the system exercises the following controls over 
the job. 



FIELD LENGTH CONTROL 

Before the system begins to process a job step (control statement), it establishes the 
initial field length for that step from the first one of the following that applies. 

1. The field length requirement is specified by RFL= and MFL= special entry 
points. This is true of several system routines (refer to appendix F, volume 
2). 

2. The routine contains the field length required in a loader table (54 table). 

3. An initial running field length (RFL) has been specified with an RFL control 
statement or a SETRFL macro call. 

4. Either the maximum field length (MFL) for the job step or the system default 
(50000B) is chosen, depending on which is the smaller. 



t Not currently supported by the system but reserved for future use. 
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The maximum field length for a job (MAXFL) is the smallest of the following values. 

• The field length specified on the job statement 

• The maximum field length for which the user is validated 

• The maximum field length available to the user for processing of this particular 
job (machine size) 

For each job step, there is an MFL, which cannot be exceeded during processing of 
that step. MFL may be reset between job steps with the MFL control statement; 
however, MFL cannot exceed MAXFL, the maximum field length for the job. 

Assuming no other overriding information (RFL= or MFL= entry points or 54 loader 
table), the system begins a job step with the initial running field length (RFL) as set 
by a previous RFL control statement or SETRFL macro call. RFL may not exceed 
MFL, the upper bound for the particular job step. After processing of the job step 
has begun, additional field length may be acquired with the MEMORY macro call; how- 
ever, the field length cannot be increased above MFL. 

The levels of maximum field length may be summarized with the formula 

RFL< MFL£ MAXFL 

which states that the initial running field length cannot exceed the maximum field length 
for a job step which cannot exceed the maximum field length for a job. 

The flow of processing to determine field length for each job step is shown in figure 
1-3-6. 



Examples of field length control: 

Control Statement Field Length 

JOB(CM60000, T1000) 700 



USER(USERABC, 1234567, FAM1) 700 



RFL(50000) 



400 



ATTACH(OPL=OPLX) 



1600 



Comments 

MAXFL and MFL are both set to 
60000. RFL is set to 0, indi- 
cating system control of FL. 
Field length is set to 700 to 
allow ACCFAM to run. 

ACCFAM, which processes the 
USER control statement, has an 
RFL= special entry point. 

The RFL control statement sets 
RFL at 50000, indicating an 
initial running field length for 
job steps with no other over- 
riding considerations. The field 
length is set to 400, because 
the utility that sets the running 
field length (CONTROL) has an 
RFL= special entry point. 

Field length is set to 1600, 
because the utility that attaches 
files (PFILES) has an RFL= 
special entry point. 
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yes 




yes 




yes 





yes 



yes 



yes 



SET FIELD LENGTH 
TO 50000 8 



SET FIELD LENGTH 
TO MFL 



SET FIELD LENGTH 
TO VALUE SPECI- 
FIED BY ENTRY 
POINT ROUTINE 



SET FIELD LENGTH 
TO VALUE SPECI- 
FIED IN 54 LOAD- 
ER TABLE 



JOB STEP BEGINS 
WITH RFL. ADDI- 
TIONAL FIELD 
LENGTH MAY BE 
ACQUIRED DURING 
PROCESSING 







ABORT THE JOB 



Figure 1-3-6. Field Length Control Processing 
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Control Statement 



Field Length 



Comments 



MODIFY(L=0, Z) /*EDIT, FORT 36600 



FTN(I) 



50000 



LGO. 



15000 



FTN(I=TAPE1) 



50000 



REWIND(TAPE1, COMPILE) 



1000 



Modify increments in 2000-word 
blocks to the table size required 
to complete the Modify operation. 

FTN has a pseudo MFL= entry 
point supplied through the FL 
directive of SYSEDIT. This has 
a value of 42000. The 50000 from 
the last RFL statement is the 
larger value and is used. 

The loader automatically reduces 
the job field length after perform- 
ing a relocatable load. (RFL= is 
not present in LGO. ) The loader 
requires a field length of 30200 to 
load itself. It increments in 
4000 word blocks until the required 
table space is available. 

FTN has a pseudo MFL= entry 
point supplied through the FL 
directive of SYSEDIT. This has 
a value of 42000. The 50000 from 
the last RFL statement is the 
larger value and is used. 

The system sets the field length 
because REWIND utility has 
RFL= set. (FILES is the utility 
package. ) 



SAVE (LGO= BIN) 



MFL(40000) 



1600 



400 



RFL(30000) 
LIBEDIT(P=0,N,V) 



400 
30000 



The SAVE utility also has RFL= 
set. (PFILES is the utility 
package. ) 

MFL is reset to 40000. No fol- 
lowing job step can exceed this 
value of MFL. The MFL con- 
trol statement is also processed 
by CONTROL. RFL is cleared. 

RFL is set to 30000. 

Because LIBEDIT has no RFL= 
specified, the system restores 
the field length to the running 
field before processing LIBEDIT. 
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INPUT FILE CONTROL 

All user jobs, when initiated, have a file named INPUT. This file contains the control 
statements and other input records required for job execution. INPUT is a locked file. 
As a result, the user may read from it and reposition it, but the system does not 
allow him to write on it. If for some special reason the user needs to write on 
INPUT, he should first issue a RETURN(INPUT) control statement (refer to section 7). 
This statement changes the name of the file from INPUT to INPUT* and leaves it 
attached to the user's job. The change of name on RETURN applies only if the input 
file is of type INFT. 

TIME LIMIT CONTROL 

The system sets a time limit for each job step unless the job statement specifies a job 
step time limit. This time is the amount of central processor time that any one job 
step is allowed. The maximum time allowable on the job statement is 777703 seconds. 
Any job in the system with a time limit of 77771s through 77777s seconds has an in- 
finite amount of central processing time at its disposal. If the user wants to change a 
job's time limit, the SETTL control statement or macro is used. The user cannot, 
however, increase the limit beyond that for which he is validated. 

While a job is using the central processor, the time of usage is accumulated and 
checked against the time limit for each job step. If the job is not a time-sharing 
(TXOT) job, the job in execution is aborted when the time limit is reached. Time- 
sharing origin jobs are rolled out, after which the user can increment the time limit 
and resume execution from the point where the time limit was exceeded. Refer to the 
Time-Sharing User's Reference Manual for a more detailed description. 



SRU LIMIT CONTROL 

The system sets a limit on the number of system resource units (SRU) that a job step 
or an account block can accumulate. An SRU includes central processor time, central 
memory usage, permanent file activity, and mass storage and tape I/O. An account 
block is that portion of a job from one CHARGE statement to the end of the job or the 
appearance of another CHARGE statement. The user may alter these limits through 
the SETJSL and SETASL control statements or macros; however, he may not set either 
limit beyond that for which he is validated. 

While a job is in the system, SRU usage is accumulated and checked against the SRU 
job step and account block limits. If the job is not a time -sharing job (TXOT), the 
job is aborted when either limit is reached. Time-sharing jobs are rolled out. After 
a time -sharing job is rolled out, the user can increment the limit and resume execu- 
tion from the point where the limit was reached. (Refer to the Time-Sharing User's 
Reference Manual for more details. ) 
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ROLLOUT CONTROL 

Each executing program is allowed to reside in CM for a certain amount of time before 
relinquishing its space to another program. When this CM time slice is exceeded, 
the program may be rolled out. This means that the contents of the- job field length, 
the job control area, and the control registers (exchange package) are written to mass 
storage. The program remains on mass storage until it is rolled back into memory. 
Execution resumes from the point where rollout occurred. The amount of time the job 
is allowed to occupy CM is called the central memory time slice. The central memory 
time slice is a system parameter that can be changed only by the system operator. 
The time slices vary for each origin type. Whether a job is rolled out when its time 
slice expires depends on several factors. 

• Whether there are jobs waiting in the input and rollout queues 

• Whether the jobs that are waiting have a lower priority 

• Whether jobs that are waiting require more field length than would be available 
if all jobs of lower priority were rolled out 

When a job is rolled out, it is assigned a queue priority. The priority assigned is a 
system parameter and can be changed only by the system operator. The queue priori- 
ties can vary for each origin type. The queue priority is aged (incremented) while the 
job is in the rollout queue. Normally, all other factors being equal, the job with the 
highest queue priority is selected to be rolled in. 

ERROR CONTROL 

The exit mode feature allows the programmer to select conditions that permit the sys- 
tem to discontinue normal processing when errors occur. The error conditions and 
associated condition codes that can occur are: 

• Illegal instruction (00) The CPU attempted to execute an illegal or 

nonavailable instruction. 

• Address is out of range (01) One of the following conditions has occurred. 

The program attempted to reference 
CM memory or ECS outside the 
established limits. 

The program is attempting to branch 
to an address outside the user's 
field length. 

• Operand is out of range (02) Floating-point arithmetic unit received an 

infinite operand. 

• Indefinite operand (04) Floating-point arithmetic unit attempted to 

use an indefinite operand. 

• ECS flag register operation Parity error was detected on ECS flag register 
parity error (10) t operation. 



tApplicable to CDC CYBER 170 series only. 
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CMC input error (20) t 



CM data error (40) t 



The address or data sent by the CPU had 
incorrect parity at the central memory control 
(CMC) or CM, 

Double data error (two data bits failed) be- 
tween the CMC and CM, detected by the 
single- error correction double- error detection 
(SECDED) network, or a data parity error 
between the CMC and CM when operating in 
default mode (in other words, the SECDED 
network has been disabled). 

The user can select any combination of these conditions with the MODE control statement 
(refer to section 6). If one of these errors occurs and the proper mode for that 
error is selected, the system notes the error by setting the appropriate error flag 
and exiting from normal processing. The following dayfile error message occurs 
defining the error exit conditions. 

CPU ERROR EXIT xx AT yyyyyy. 

This message identifies the error condition by the condition code xx (as listed above) 
that was detected at location yyyyyy. If the exit mode is not selected, the central 
processor stops or proceeds depending on the situation. For a detailed explanation, 
refer to the appropriate hardware reference manuals. 

When activity at a control point ceases, the system determines the reason. If an 
error flag is set, the error is noted and execution is resumed at the error exit 
address if one was specified. Error exit addresses are set by the EREXIT macro 
(refer to section 6, volume 2). 

Once control is transferred, the error flag is cleared. If the error occurs because 
the central processor time limit is exceeded, the job is given another 10g seconds to 
complete processing. If the error is caused by a central processor abort (refer to 
ABORT macro), the address at which the error occurred is specified and normal 
error processing continues. 

When control is transferred from an executing program because of an error, the sys- 
tem determines whether or not to continue with control statement processing, perform 
error processing, or terminate the job. 

The system first searches for an EXIT control statement. If an EXIT statement is found, 
error processing begins with the statement following EXIT. If, prior to the detection of 
the error, the system encountered a NOEXIT statement, no search is made for an EXIT 
statement and processing continues with the next control statement. If no EXIT or NOEXIT 
statement was encountered, the system terminates the job. 



t Applicable to CDC CYBER 170 series only. 
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SECURITY CONTROL 

Unless the job is system origin type or the user is validated for system origin 
privileges and DEBUG mode has been set at the system display console, system 
security imposes the following restrictions on control statements which dump any por- 
tion of the field length of the previous job step. 

• They may not follow the execution of certain protected system programs (refer to 
section 2, volume 2 for further definition). 

• They may not follow user programs which have requested protection (refer to the 
description of the SETSSM macro, section 6, volume 2). 

Violation of these restrictions results in the control statement being ignored and the 
following informative message being entered in the dayfile. 

SECURE MEMORY, DUMP DISABLED. 
The following are the restricted control statements. 



CATALOG 


LIBEDIT 


CKP 


LOC 


COPYB 


PBC 


COPYC 


RBR 


DMD 


VERIFY 


DMP 


VFYLIB 


EDIT 


WBR 


LBC 


RESTART 



JOB COMPLETION 

When there is no more activity at a control point, no outstanding central processor requests, 
and no control statements to process, the job is completed in the following manner. 

1. All CM assigned to the job is returned to the system. 

2. All equipment assigned to the job is returned to the system. 

3. All library files attached to the job are returned ; other jobs can then access 
them. 

4. All scratch (local) file space used by the job is released. 

5. All direct access permanent files attached to the job are returned; the status 
information for these files is updated. 



60435400 C 1-3-15 



6. The following summations of job activity are added to the end of the user's dayfile. 
This information is also issued to the associated account dayfile. The entries in 
the account dayfile also include the job name. 

• Application charge activity in kilounits: 

hh. mm. ss. UEAD, xxxxxx. xxxKUNS. 

• Permanent file activity in kilounits: 

hh. mm. ss. UEPF, xxxxxx. xxxKUNS. 

• Mass storage activity in kilounits: 

hh. mm. ss. UEMS, xxxxxx. xxxKUNS. 

• Magnetic tape activity in kilounits: 

hh. mm. ss. UEMT, xxxxxx. xxxKUNS. 

• Accumulated central processor time in seconds: 

hh. mm. ss. UECP, xxxxxx. xxxSECS. 

• SRU value in units for total job usage including CPU time, I/O activity, 
and memory usage: 

hh. mm. ss. AESR, xxxxxx. xxxUNTS. 

• Lines printed in kilolines: 

hh. mm. ss.UCLP, es, xxxxxx. xxxKLNS. 

es EST ordinal of the file 

The following information is issued to the account dayfile only: 

• Cards read in kilocards: 

hh. mm. ss. jobname. UCCR. es. xxxxxx. xxxKCDS. 

• Cards punched in kilocards: 

hh. mm. ss. jobname. UCPC. es. xxxxxx. xxxK CDS. 

7. Control point dayfile is copied to the end of the print file. 

8. All output files are released to the output queue. 

9. The control point area is cleared for the next job. 
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CONTROL LANGUAGE 



The operating system control language allows the programmer to transfer control and 
to perform arithmetic and test functions within the control statement record. Control 
language consists of statements similar to FORTRAN statements. These statements 
are normally composed of a command (as listed below), parameters, symbolic names, 
and expressions. The following are legal commands. 



GOTO 


SET 


CALL 


IF 


DISPLAY 





An important feature of control language is the capability to create procedure files. A 
procedure file is a group of system control statements and /or control language state- 
ments which can be called much like a subroutine for insertion anywhere within the 
control statement record. It is activated either by the CALL statement or the name of 
the procedure file. Because control statements, control language statements, or both 
are allowed in a procedure file, the user is given a much wider range of control for 
manipulating his files. 

The following sections describe the various components and commands of the system 
control language. 



EXPRESSIONS 

The expressions allowed are similar to FORTRAN expressions and may contain con- 
stants, arithmetic operators, relational operators, Boolean operators, functions, and 
symbolic names. 

CONSTANTS 

Numeric constants are assumed to be decimal. If a constant has a postradix of D, it 
is decimal. If it has a postradix of B, it is octal. 

ARITHMETIC OPERATORS 

Arithmetic operations are performed in ones complement with 48-bit evaluations. The 
arithmetic operators processed are: 



+ 


Addition 


- 


Subtraction 


* 


Multiplication 


/ 


Division 


**• t 


Exponentiation 
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Leading - Negation 
Leading + Ignored 

RELATIONAL OPERATORS 

Relational operations produce the value 1 if the relation is true and a value of if the 
relation is false. The relational operators are (either form may be used): 



= 


.EQ. 


Equal to 


/ 


.NE. 


Not equal to 


< 


.LT. 


Less than 


> 


.GT. 


Greater than 


< 


.LE. 


Less than or equal to 


> 


.GE. 


Greater than or equal to 



BOOLEAN OPERATORS 

The Boolean operators are (either form may be used): 
= .EQV. Equivalence 
V . OR. Inclusive OR 
A .AND. AND 
J . EOR. Exclusive OR 
' .NOT. Complement 

FUNCTIONS 

Two functions are provided for use in expressions specified with control language state- 
ments. The FILE function determines the status of any file assigned to the job. The 
NUM function determines if a specified parameter name has a numeric value. For 
complete information concerning format and use, refer to Control Language Functions 
in this section. 



SYMBOLIC NAMES 

Symbolic names are used to reference values pertaining to the job process. There 
are three categories of symbolic names, as follows: 

• Symbolic names with fixed arithmetic values: 
ARE Arithmetic error 

BCO Local batch origin 
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CPE 


CPU abort 


EIO 


Remote batch (Export /Import) origin 


FLE 


File limit error 


MNE 


Monitor call error 


ODE 


Operator drop 


PEE 


CPU parity error exit 


PPE 


PPU abort 


PSE 


Program stop error 


SRE 


SRU limit error 


SYO 


System origin 


TKE 


Track limit error 


TLE 


Time limit error 


TXO 


Time -sharing origin 


• Symbolic names 


with variable arithmetic values which depend up 


EF 


Previous error flag 


EM 


Current exit mode 


FL 


Job field length 


OT 


Job origin type 


Rl 


Contents of control register 1 


R2 


Contents of control register 2 


R3 


Contents of control register 3 


SS 


Job subsystem; in expressions, SS may be equ: 
of the following. 




ACCESSf 




BASIC 




BATCH 




EXECUTE 




FTNTS 




NULL 




TRANACTf 


• Symbolic names 


with Boolean values: 


F 


False value 


FALSE 


False value 


SWn 


Setting (l=on, 0=off) to sense switch (1 <n <6) 


T 


True value 


TRUE 


True value 



I 



tSpecial validation is necessary to access and use ACCESS and TRANACT. Refer to the 
LIMITS statement, section 6. 
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EVALUATION OF EXPRESSIONS 

The order of evaluation of expressions is: 

1 . Exponentiation 

2. Multiplication, division 

3. Addition, subtraction, negation 

4. Relations - 

5. Complement 

6. AND 

7. Inclusive OR 

8. Exclusive OR, equivalence 

Nesting of expressions to any depth is allowed within a statement. 

CONTROL LANGUAGE STATEMENTS 

Control language statements are described in the following paragraphs, 
and terminators must be used as shown in the statement formats. 



Separators 



GOTO STATEMENT 

The GOTO statement transfers control to another location within the control statement file. 
The statement format is: 



GOTO, stmt. 

stmt 



Name of any control statement or a digit (0 through 9) followed 
by a maximum of six alphanumeric characters, terminated by 
a period. 



Example 1 



Example 2 



GOTO 



1WX2 



1WX2. 



REQUEST (TAPED 



REQUEST (TAPED 



GOTO 



REQUEST. 



REQUEST(TAPE2) 
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When stmt appears more than once in the control statement file, the stmt to be executed is 
the first occurrence of stmt from the beginning of the control statement file. Hence, in 
both of the previous examples, the REQUEST (TAPE1) statement is processed after the 
GOTO statement. 



CALL STATEMENT 

The CALL statement allows the user to insert a file consisting of a group of control state- 
ments (procedure file) at the specified position in the control statement stream. This file 
is merged, as specified on the CALL statement, with the current control statement record 
into a third record. This third record becomes the current control statement record. The 
remainder of the input file is then copied to the new control statement record. If the C 
option is exercised, the current control statement record is not used. Only the source file 
is used to generate a new control statement record. All options are order-independent. 

The statement format is: 

CALL(lfn,C, S=ccc, RENAME(oldnam 1 =newnam 1 , oldnam 9 =newnam 9 , . . . , 
oldnam =newnam ) i l z z 

n n 



or 



CALLQfn, C, S=ccc (oldnam- =newnam 1 , oldnanip=newnam 2 , . . . , oldnam =newnam ) 



lfn 



C 

S=ccc 

RENAME 

oldnam. 

1 

newnam. 



Procedure file name (refer to the description of procedure files 
in this section for further information). The system obtains lfn 
by: 

1. Searching for a local file, lfn 

2. Searching the system library for lfn 

3. Attempting to retrieve a working copy of an indirect 
access file 

Replaces all of the control statement record after the CALL 
statement with lfn. 

Sets next control statement to be processed to statement ccc. 
If S is not specified, the first statement in lfn is processed. 

Each occurrence of oldnam. is replaced with newnam. before 
the statement is entered int 1 © the statement file. As shown by 
the optional format, the word RENAME does not have to appear. 

Old name; name of a file or statement label used in the 
specified procedure file 

New name; name to replace oldnam. 
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DISPLAY STATEMENT 

The DISPLAY statement determines the current subsystem or evaluates an expression 
and displays the result in the dayfile. Numeric results are displayed in both octal 
and decimal formats. Expression evaluation is significant only to 23 bits. Therefore, 
the octal representation of a negative number may be incorrect. 

The statement format is: 
DISPLAY(SS) 

or 
DISPLAY (expression) 

expression Any legal expression 

Example 1: 

DISPLAY(SS) 

If the BASIC subsystem is currently in use, the preceding statement inserts the follow- 
ing message into the dayfile: 

BASIC 

Example 2: 

DISPLAY((R1+R3) * R2) 

If Rl=5, R2=8, and R3=3, this statement inserts the following data in the dayfile. 

64 100B 

Both decimal and octal values are displayed. 

SET STATEMENT 

The SET statement allows the user to specify a subsystem or to set software registers 
to control the flow of a job. These registers are useful when designing a multipurpose 
procedure file. They also can be used to select a particular option in the procedure 
file. These software-defined registers are kept in the job control area and are pre- 
served for the duration of the job. The control register specified in the control state- 
ment is set to the value of the expression supplied. This register can be Rl, R2, R3, 
or EF (refer to Symbolic Names earlier in this section). The R registers are 18-bit 
quantities whereas the error flag (EF) is a 6 -bit quantity. Excess bits are ignored. 

The statement format is: 
SET(Ri=expression) 

or 
SET(EF=expression) 

or 

SET(SS=ssname) 

Ri Software -defined register 1, 2, or 3 

EF An additional register 

expression Any legal expression 

ssname Any legal SS subsystem name 
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Example: 

This example illustrates the use of the SET statement to control execution of an object pro- 
gram. Because register Rl is set to 1 when file ABC is called, the object program is not 
executed. 

SET(R1=1) 

CALL(ABC) 

FTN. 

IF(R1=1) GOTO, 3. 

REQUEST(TAPEI) 

LGO. 

3, REWIND(TAPEI) 



IF STATEMENT 

The IF statement is used to evaluate an expression. If the conditions given in the expression 
are true, the dependent statement is processed. The expression is considered true if it is 
evaluated to a nonzero numeric value. 

The statement format is: 
IF(expression)stmt. 

or 
IF(SS op ssname)stmt. 

or 

IF(SS op ssname expression) stmt. 

expression Any legal expression 

stmt Any legal control statement 

op One of the operators: 

. EQ. 

. NE. 
ssname Any legal SS subsystem name 

Example 1: 

IF(R2 =R1. AND. R3)GOTO, REQUEST. 
SET(EF=1) 



REQUEST(TAPE) 

If the expression is true, the REQUEST control statement is executed; otherwise, the SET 
statement is executed. 
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Example 2 : 



IF(SS.EQ.BASIC.AND.OT=TXO.AND. Rl=l)GOTO, 100. 
SET(SS.EQ. BASIC) 



100, OLD, BAS. 



If the statement is true, the OLD control statement is processed; otherwise, the SET state- 
ment is processed. 

CONTROL LANGUAGE FUNCTIONS 

Control language functions are described in the following paragraphs. Separators and 
terminators must be used as shown in the function formats. 



FILE FUNCTION 

The FILE function is used to determine the status of any file assigned to the job and 
is used in conjunction with the SET, IF, and DISPLAY control language statements. 

The format of the function is: 

FILE(lfn, expression) 

lfn File name 

expression Any legal expression; however, FILE expressions cannot 

include functions. In addition, FILE expressions use 
different symbolic names, as follows: 

Symbolic names: 

Names with values 

EQ Equipment status table (EST) ordinal! 

<0 through 77s) 
ID File ID (0 through 67g) 

Names with true/false values 

MS File is on mass storage 

LK File is locked 

OP File is opened 

EX Execute-only file 

AS File is assigned to user's control point 

File types 

LO Local 

PR Print 

IN Input 

PH Punch 

LI Library 

PM Direct access permanent file 

PT Primary 



t Contact installation personnel for a list of EST ordinals. 
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Device types 

CP 415 Card Punch 

CR 405 Card Reader 

DE Extended Core Storage 

DI 844-21 Disk Storage Subsystem 

DJ 844-41/44 Disk Storage Subsystem 

DP Distributive Data Path to ECS 

LP 512 or 580 Line Printer 

LQ 512 Line Printer 

LR 580-12 Line Printer 

LS 580-16 Line Printer 

LT 580-20 Line Printer 

MD 841 Multiple Disk Drive 

MS Mass Storage 

MT Magnetic Tape Drive (7 -track) 

NE Null equipment 

NT Magnetic Tape Drive (9-track) 

TT Time -Sharing Multiplexer 

NP Host Communications Processor 



Examples: 



SET(R 1=FILE(TAPE, MT)) 

If TAPE is a file on a 7 -track Magnetic Tape Drive, Rl is set to 1; otherwise, it is 
set to zero. 

IF(FILE(BETA, MD. AND. PM))GOTO, 200. 

If BETA is a file on an 841 Multiple Disk Drive and it is a direct -access permanent 
file, processing goes to the statement at 200. 



NUM FUNCTION 

The NUM function is used to determine if the specified parameter name has a numeric 
value. It is used in conjunction with the SET, IF, and DISPLAY control language state- 
ments. 

The format of the function is: 

NUM(name) 

name 



Parameter name. If the name is numeric, the statement is 
true; otherwise, it is false. 



Example: 



If the following CALL statement was used to call procedure file A 

CALL(A, RENAME(2XY=2, T = TAPE)) 
the IF statement in A 

IF(NUM(2XY))GOTO, IS. 
would be evaluated as true, and control would transfer to IS. 
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However, the statement 

IF(NUM(T) )GOTO, IS. 
would be evaluated as false, and control would pass to the next statement in A. 

PROCEDURE FILES 

Procedure files are source files consisting of control statements, control language state- 
ments, or both. The first statement of a procedure file may be the file name. If the 
first statement is the same as the file name used in the CALL statement, the first 
statement is ignored. Procedure files are activated by the CALL statement or by using 
the name of the procedure file, if the file is in the system. 

Example 1: 

The procedure file in this example is an indirect access file called COMPARE. This 
routine copies an input file and compares it with an existing direct access file. In the 
procedure file, these two files are called DUPL and MASTER. When the procedure 
file is inserted into the control statement record during job processing, the name of 
DUPL is changed to NEWFILE. 

Original Input File 

JOBAAA. 

USER(EFD2501, PASS) 
CHARGE(59, 69N1) 
CALL(COMPARE(DUPL=NEWFILE) 
-EOR- 

• * • 

input file 

that is to 

be compared 

■-EOI- 

Procedure File COMPARE 

COMPARE 
COPBR(,DUPL) 
ATTACH(MASTER) 
VFYLIB(MASTER, DUPL> 



1-4-10 60435400 C 



After the CALL control statement is processed, the control statement record is as 
follows: 

JOBAAA. 

USER (EFD2501, PASS) 

CHARGE(59,69N1) 

CALL(COMPARE(DUPL=NEWFILE» 

COPYBR(, NEWFILE) 

ATTACH (MASTER) 

VFYLIB(MASTER, NEWFILE) 

-EOR- 

Example 2: 

This is an example of nested calls. It illustrates the use of one procedure file to 
skip a specified number of files on a tape (contents of Rl) and to copy source data to 
the tape. The other procedure file retrieves source data from the OPL (old program 
library) and calls the first procedure file to place that source data on the tape. 

Input Deck 

JOBAAA. 

USER(USERNUM, PASSWRD, FAM 1) 

CHARGE(59, 69N1) . 

ATTACH(OPL/UN=LIBRARY) I 

REQUEST(TAPE) ■ 

MODIFY(S, Z) /*EDIT, CPM ■ 

SET(R1=0) ■ 

CALL(PROC, RENAME(A =TAPE, B =SOURCE, 2 =2A, 3 =3 A) 

SET(R1=R1+1) 

CALL(PROB) 

-EOR- 

Procedure File PROB 



PROB 

MODIFY(S=NEW,Z)/*EDIT,MTR 
CALL(PROC, RENAME ( A =TAPE, B=NEW) 
RETURN, NEW. 

Procedure File PROC 

PROC 

REWIND(A, B) 
SET(R2=0) 

2,IF(Rl=R2)GOTO, 3. 
SKIPF(A) 
SET(R2=R2+1) 
GOTO, 2. 
3,COPYBF,B,A. 



NOTE 



On job initiation, the user's input file is a locked file. 
If the user wishes to call procedure files that write 
data on the input file, he should enter the RETURN 
(INPUT) control statement before attempting to write on 
INPUT. For further information, refer to Input File 
Control, section 3. 
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TIME-SHARING COMMANDS 

The following commands are intended for use only by time-sharing origin jobs but in- 
cluded here for their use in procedure files. For additional information about these 
commands, refer to the Time-Sharing User's Reference Manual. 

ASCII STATEMENT 

The ASCII control statement specifies that all subsequent operations are to be done in 
ASCII character set mode. 

The control statement format is: 
ASCII. 

If this control statement is processed while output is still available, the terminal 
switches to ASCII mode for the remainder of the output. 

CSET STATEMENT 

The CSET control statement specifies the current character set mode of the terminal. 

The control statement format is: 
CSET(m) 

m Current terminal character set mode; m may be one of the following. 

ASCII Set ASCII character set mode; escape code processing 

is enabled 
NORMAL Set normal character set mode; escape code processing 

is disabled 

If this control statement is processed while output is still available, the terminal 
switches to the new character set mode for the remainder of the output. 

PARITY STATEMENT 

The PARITY control statement sets the terminal to the indicated parity. 

The control statement format is: 

PARITY(p) 

p Terminal parity; p may be one of the following. 

ODD Set odd parity 

EVEN Set even parity 

If p is omitted, odd parity is assumed. 

If this control statement is processed while output is still available, the terminal parity 
switches to the new parity for the remainder of the output. 
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CONTROL STATEMENT PROCESSING 



Jobs entering the system consist of one or more logical records. The first logical record 
contains system directives (control statements) which describe the processing that is to 
occur in the job file (job deck). This section describes control statement processing and 
how the control statements affect other aspects of job processing. 

The operating system recognizes three types of control statements. 



Local File Control Statements 



System Control Statements 



Product Set Control Statements 



These statements call files that are assigned 
to the job control point. LGO is the system 
default local file used for retaining object 
code generated by one of the language proc- 
essors described in section 11. 

These statements are divided into eight 
categories. 

Job control control statements 

File management control statements 

Permanent file control statements 

Load and dump central memory utility 
control statements 

Tape management control statements 

Program library utility control statements 

System utility control statements 

Loader control control statements t 

The product set control statements call the 
various products available under NOS (refer 
to section 11). 



CONTROL STATEMENT FORMAT 

All control statements may consist of from one to four fields. The first field is the state- 
ment label field. If present (the field is optional), it begins with a numeric character and 
terminates with a separator character. The field is used only in conjunction with the 
system control language described in section 4. 

The second field, also optional, is a $ or / prefix character which precedes the program 
name. If a $ is present, it indicates that the specified program to be executed must be loaded 
from the system library. | Therefore, even if a local file of the same name is present, it 
will not be executed. The / option may be used on local file control statement calls. If a / 
is present, it indicates that the parameters following the program name are to be processed in 
the operating system format. If a / is not present, the parameters are processed in product 
set format. The default is product set format because it is assumed that most programs spe- 
cified in local file calls have been generated by one of the product set members. The / option 
does not apply for control statement calls to programs residing on the system library. For 
those types of calls, parameters are processed in the operating system format unless the SC 
directive to SYSEDIT has been entered. Refer to the SYSEDIT control statement in the 
installation handbook for a description of the SC directive. 



t Refer to the CDC CYBER Loader Reference Manual. 
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The third field contains the name of the program to be executed. The fourth field (optional) 
contains parameters which further define the operation to be performed. The parameter 
field is set off from the name field by a separator character. After the fourth field or the 
third field if no parameters are present, there must be a valid terminator character. 

I The following is a comparison of the operating system and product set formats (refer 
to section 11 for a list of control statements processed in product set format). 



Operating System Format 

1. Valid separators are 

+ -"/=.< 

and any other character with a display 
code value greater than 44g except 
*)$. and blank. 

2. Valid terminators are 



Product Set Format 
Valid separators are 
+ -"/=,< 

and any other character with a display 
code value greater than 44 g except 
* ) $ . and blank. 

Valid terminators are 



.) 



.) 



3. Letters, numbers, and the 
* are the only characters 
allowed in the parameter 
field. The one exception to 
this rule is the use of lit- 
erals (that is, character 
strings delimited by dollar 
signs). Characters other 
than letters, numbers, and 
the '* can be included in lit- 
erals. No characters within 
a literal have special mean- 
ings; the system merely checks 
the syntax of the literal. 

The called program must do its 
own processing of the literal. 

Literals are allowed only on 
equipment /file assignment 
control statements and control 
statements for loader control. 

4. All embedded blanks within a 
control statement except those 
appearing in literals are 
ignored. 



Any parameter field that includes 
characters other than letters, num- 
bers, and the * must be expressed 
as a literal. 



All embedded blanks within a control 
statement except those appearing in 
literals or after the program name 
are ignored. 



5. Comments may appear on the 
control statement but they must 
follow the terminator. They 
may contain any character. 
Comments are not printed for 
some control statements. 



Same as for the operating system 
format. 
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Operating System Format 



Product Set Format 



6. Parameters, separators, 
and terminators are stored 
in the user's field length 
beginning at RA+2. The 
characters , . and ) are stored 
as zero. For all parameters 
and all valid separators except 
the comma, their display code 
equivalent is stored. 



6. Parameters are stored in their display 
code equivalent beginning at RA+2. 
Separators and terminators are stored 
as follows: 



Character 




Code (Octal) 


» 




1 


= 




2 


/ 




3 


( 




4 


+ 




5 


- 




6 


* 




10 


) or . 




17 


Other valid 
separators 


16 



7. File names are 1 to 7 alpha- 
numeric characters. 

8. Not NOS/BE compatible 



7. 



8. 



File names are 1 to 7 alphanumeric 
characters. File names beginning 
with a numeric character are illegal. 

NOS/BE compatible 



In general, no parameter can contain more than 7 characters. If a parameter contains 
more than 7 characters, the entire control statement is issued to the dayfile, followed 
by the message: 

FORMAT ERROR ON CONTROL CARD. 

There are two exceptions to this rule. If a statement calls a program from the system 
library that has an ARG= entry point, parameters in the statement can contain more 
than 7 characters. If a parameter contains more than 7 characters, the ARG= entry 
point is not present, and the SDM= entry point is present, the statement name (such as 
DEFINE) is issued to the dayfile but all parameters are suppressed. 

The parameters can appear in either order- dependent or order-independent format. Order- 
dependent parameters are required when the parameters must be passed in a specific order. 
An example of order-dependent parameters is: 

RESEQ(MYFILE, B, , 20) 

In this example, the system expects the resequencing increment to be passed as the 
fourth parameter; therefore, a separator must be present for the parameter not speci- 
fied. 

Order- independent parameters may be passed in any order. This is made possible by the 
use of keywords. Keywords' are identifiers which have meaning either by themselves or 
when used in conjunction with other parameters. Usually, keywords are passed with a 
parameter and a separator. The separator must not be a comma. When the list of param- 
eters is. passed to the called program, all separators except commas are also passed. 
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Some programs require specific separators (usually =), and others merely require that a 
separator be present. Examples of keyword notation are: 

1. COBOL(I=SFILE,B=BFILE) 

2. COBOL(B=BFILE,I=SFILE) 

3. COBOL(L*0,A,F) 

4. JOBX,T10,CM45000. 

In examples 1 and 2, both parameters and separators are passed to the COBOL com- 
piler. Since these parameters are order-independent, both statements produce the 
same result. 

In example 3, two keywords are passed with no separator character or parameter. In 
example 4, the keyword is the first character of the parameter. 

The control statements are processed in the following manner: parameters are extracted 
from the control statement and stored in the user's field length beginning at ARGR (RA+2) 
through RA+n (n cannot exceed 63g). t The total number of parameters stored in the user's 
field length is placed in the lower 18 bits of RA+648. The name of the control statement is 
placed in bits 18 through 59 of RA+64 8 . 

The control statement image, less any label or prefix field, is stored at RA+70g. If the pro- 
gram being executed was loaded from the system library and has an ARG= entry point, then 
the entire control statement image will be present at RA+7O3. Neither the information on 
arguments nor the argument count, however, will be entered when ARG- is present. This 
entry point allows for control statements with special parameter requirements (refer to 
appendix F, volume 2). 

An example of how the control statement 
I PERMIT (FILEABC, USERAAA=R,USERBBB=W) 



appears in CM is illustrated. 



Memory 
A 



Display Code 
Equivalent 
_A 



ARGR 



RA + E 



RA + b 



Dbll 1M0S 
ESE3 D5ES 



EEOD 
ESE3 
S7DD 



DDDD 
05EE 



01DE 
0101 
DDDD 
OEDE 



0300 
D100 



005M 



DDDO DDDD 
DEDD 00SM 



DDDD DDDD DDDD DODO 



V 1— 

0000 FILEABC 

USERAAA 

R 

USERBBB 

U 



ACTR 
CCDR 



RA+tM 
RA+70 



RA+73 



SD0S EE1S HEM SbDb 111M PERMIT (FIL 

0501 0E03 DDES E305 SE01 EABC USERA 

0101 SMSE SbES E30S SS0S AA=RtUSERB 

0E0S SMS? S7SS 0DD0 DDDD BB=U) 



The following control statements would provide exactly the same image in CM. 

123, PERMIT (FILEABC, USERAAA=R,USERBBB=W) 
123,$PERMIT (FILEABC, USERAAA =R,USERBBB=W) 



JOB STATEMENT FORMAT 

The first statement of the control statement record is always the job statement. The job 
statement may be in either order-dependent or order -independent format. When the job 
statement is in order-independent format, the keyword and parameter are passed with no 
separator character. The format for the job statement is: 



t The first 100 8 words of the user's field length, from RA through RA+77s, comprise 
the job communication area. Refer to appendix E, volume 2 for a description of 
this area. 
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jobname(Tt, CMfl, Pp) cm 

jobname(p,t,fl) cm 

jobname Alphanumeric job name (1 to 7 characters) which must begin 

with a letter. This name identifies individual jobs being run 
under the same user number. 



t Central processor job step time limit in octal seconds, 

ranging from 1 to 77770g. The time limit must be suffi- 
cient for completion of each job step in the job. If t is 
absent, the system assumes t equals 100s (100g seconds is 
approximately 1 minute). 

fl Maximum CM field length (storage requirement) for the job. 

The system rounds the value to the next highest multiple of 
100g. The field length cannot exceed: 

377, 7008 on a 198K or a 262K machine 
360, 000 8 on a 131K machine 
163, 000g on a 65K machine 
61, OOOg on a 32K machine 



NOTE 



The following messages are issued to the user's 
dayfile if validation limits are exceeded. 

CM NOT VALIDATED. The number of CM words 

specified on the job state- 
ment exceeds that for 
which the user is validated. 

TL NOT VALIDATED. The time limit specified 

on the job statement 
exceeds that for which 
the user is validated. 

The user may be further restricted by limits placed on him 
by the validation file or by installation parameters. The 
user should consult installation personnel for restrictions 
based on the machine configuration and subsystems used. 

In addition, RFL (the running field length for a job step) 
will always be zero unless the user specifies a field length 
with the RFL control statement (refer to section 6). When- 
ever RFL is zero, the system is in control of field length 
assignment. The MFL (maximum field length) control state- 
ment will clear any RFL value previously set with an RFL 
control statement (refer to section 6). 



Priority level (octal) at which the job enters the system; 
1 < Pi 17 8* 

This parameter is currently ignored since the system will 
automatically assign priorities specified by the installation 
parameters. 
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cm Conversion mode contained in columns 79 and 80. A 26 

indicates coded cards are to be converted in 026 mode; 29 in- 
dicates cards are converted in 029 mode. This is the initial 
keypunch mode of the job but mode may be changed by a con- 
version change card (refer to Coded Cards, appendix F) when 
reading cards or a DISPOSE statement when punching cards. If 
this parameter is omitted, the system default keypunch mode is 
used. 

In addition to the regular separator characters, the * may also be used to separate param- 
eters on the job statement. 

If the order-dependent format is employed and null parameters are indicated with multiple 
separators, the null parameters are interpreted as zeros. 

Example: 

JOBAAA, ,, 50000. 

has the same effect as 

JOBAAA, 0, 0, 50000. or JOBAAA, P0, TO, CM50000. 

CONTROL STATEMENT PROCESSING FLOW 

The system translates a control statement by: 

1. Reading the statement from the control point control statement buffer. If necessary, 
the system reads control statements from the job input file. 

2. Deleting all spaces between the beginning of the statement and the terminator 
character (a period or a right parenthesis). In general, the system allows only 
standard FORTRAN characters to appear before the terminator character, although 
other characters can appear within a literal or in the comment field. 

3. Comparing special control statement names with the name of the control statement 
being processed. If the statement name is CTIME, RTIME, or STIME, the system 
processes the control statement. 

4. Searching the file name table for a file assigned to the job with a name identical to 
the name of the control statement. However, if a $ precedes the program name, 
this step is skipped. If an identical name is found, the program is loaded into 
memory. The arguments are extracted from the control statement and stored in 
RA+2 through RA+n+1 (n is the number of parameters). The CPU is requested to 
begin execution unless special loader control statements follow. 

5. Searching the central library directory for a program name that matches the control 
statement name. If the name is found, the system proceeds as in step 4; otherwise, 
the system searches further. 

6. Searching the peripheral processor library directory for a program name that 
matches the control statement name. If found, the name is placed, with a maximum 
of two arguments, as a peripheral processor request, and the system exits to the 
program. 

7. If the control statement name is not found during any of the above searches, the 
control statement is declared illegal and the job is aborted. 
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Figure 1-5-1 illustrates the flow of control statement processing. 



( START J 



READ A 

CONTROL 

STATEMENT 



CONTROL STATEMENT 
PROCESSOR SEARCHES 
ITS LIST OF CONTROL 
STATEMENT NAMES FOR 
SPECIAL CONTROL 
STATEMENT 




YES 



<D 




PROCESS 
SPECIAL 
REQUEST 



YES 




PROCESS FIELD 
LENGTH CONTROL 
(SEE SECTION 3) 



LOAD PROGRAM 
TO CENTRAL 
MEMORY 



STORE CONTROL 
STATEMENT AND 
CONTROL STATEMENT 
ARGUMENTS IN 
USER'S FIELD 
LENGTH 



SEARCH PP 
LIBRARY FOR 
NAME, IF NAME 
IS LEGAL PP 
PROGRAM NAME 



(EXECUTE \ 
PROGRAM J 



YES 



USE NOS FORMAT 
FOR PROCESSING 
PARAMETERS 




FOUND 
? 



NO 



YES 



PUCE NAME 
WITH UP TO TWO 
OCTAL ARGUMENTS 
AS A PP REQUEST 



SEARCH FNT 
FOR FILE 
ASSIGNED TO 
THIS JOB 



S 




EXIT TO PROGRAM 
(NO FL CHANGE) 



Figure 1-5-1. Control Statement Processing Flow 
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EXIT PROCESSING 

When an error condition occurs during job processing, the system searches the control 
statement record for an EXIT statement. If the record does not contain an EXIT state- 
ment, the system terminates the job. If the system finds an EXIT statement, it clears 
the error condition and processes the control statements that follow the EXIT statement. 
If the error was a time limit error, the limit is reset to the time used plus IO3 sec- 
onds. This gives the user time for post error cleanup operations. If the error was an 
SRU limit error, the limit is reset to the SRUs used plus 10 8 SRUs. 

If a NOEXIT statement is encountered, normal error processing is not performed. 
That is, if the no exit flag has been set (by the NOEXIT statement) prior to the error, 
the error flag is cleared, no search is made for an EXIT statement, and processing 
continues with the next control statement. An ONEXIT statement can be used to return 
to error processing mode; it clears the no exit flag. For further discussion of pos- 
sible error conditions, refer to section 3 of this manual. 

The following sequence of control statements illustrates this exit processing. 

JOBCCC. 

USER(SMITH22,SM) 

CHARGE(55A19) 

NOEXIT. 

GET(A,B) 

ONEXIT. 

ATTACH(MASTER /M=W) 

SKIPEI(MASTER) 

COPYBF(A, MASTER) 

COPYB(B, MASTER) 

PACK(MASTER) 

COPYSBF(MASTER, ) 

EXIT. 

ENQUIRE(F) 

-EOR- 

-EOI- 

This job gets local copies of two indirect access permanent files and adds them to a 
direct access file. The NOEXIT suspends error processing, and the job will continue 
even if file A and/or B is not found. The ONEXIT turns error processing back on. 
If any error occurs thereafter, processing skips to the EXIT statement and continues 
with the ENQUIRE. If no error occurs after the NOEXIT, processing continues until 
the EXIT statement and terminates (ENQUIRE is not processed). 
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JOB CONTROL CONTROL STATEMENTS 



The job control control statements enable the user to alter information that controls 
his job while in the system and to retrieve information concerning the status of his 
job. The control statements included in this category are: 



ACCOUNT 

CHARGE 

COMMENT 

CTIME 

DAY FILE 

ENQUIRE 

EXIT 

LDI 

LENGTH 

LIMITS 

MFL 



MODE 

NOEXIT 

NORERUN 

OFFSW 

ONEXIT 

ONSW 

PASSWOR 

RERUN 

RESOURC 

RFL 

ROLLOUT 



RTIME 

SETASL 

SETJSL 

SETPR 

SETTL 

STIME 

SUBMIT 

SUI 

SUMMARY 

SWITCH 

USECPU 

USER 



The user must have specific validation parameters set to use LDI, PASSWOR, SUBMIT, 
or SUI. He can use the remaining statements regardless of his validation. A listing 
of validation information can be obtained using the LIMITS statement. Although the user 
is allowed to change several control values for his job (such as RFL, SETPR, and 
SETTL), he can never specify more than that for which he is validated. 

The system uses the USER statement and CHARGE statement for checking user valida- 
tion and system accounting information. The RESOURC statement is also used by the 
system to prevent deadlocks from occurring when several tapes or packs are used 
concurrently. 

The user can submit files as batch origin type jobs through the LDI and SUBMIT con- 
trol statements.. He can specify the mode of error exit processing desired through 
use of the EXIT, ONEXIT, NOEXIT, and MODE statements. He can also set conditions 
for his program with sense switches (such as ONSW, OFFSW, and SWITCH). In the 
event of a system malfunction causing jobs to be recovered, he may either allow his 
job to be run again with the RERUN statement or prevent it from being rerun with the 
NORERUN statement. Additional information is returned to the user by the CTIME, 
RTIME, and DAYFILE statements. The COMMENT statement allows the user to pro- 
vide his own documentation. 
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ACCOUNT STATEMENT 

The ACCOUNT control statement is included for compatibility with previous systems. 
The USER control statement should be used with the present system. 



CHARGE STATEMENT 

The CHARGE statement causes the system to record on the account dayfile all informa- 
tion regarding resources used under a specified charge number/ project number combina- 
tion. Its purpose is to control the accounting activity of the system for a customer 
or the installation. 

The control statement format is: 

CHARGE(chargenum, projectnum) 

chargenum A 1- to 10 -alphanumeric character charge number assigned 

to the user 

projectnum A 1- to 20- alphanumeric character project number assigned 

to the user 

For added security, the user may issue the CHARGE statement without parameters. 
In this case, the system will read the parameters from a record in the INPUT file. 
This record must be a single line with the format: 

chargenum, projectnum 

The CHARGE statement is used in conjunction with user accounting control. An instal- 
lation which implements this feature can impose limits on the SRUs a user may accumu- 
late or restrict his access to the system to a certain time-of-day interval. 

If access option 8 is not set (refer to LIMITS control statement in this section), the 
user must include a CHARGE statement immediately following every USER statement 
in his job. If option 8 is set, the user may but is not required to include a CHARGE 
statement. A user assigned more than one charge and/ or project number may include 
additional CHARGE statements in his job to record resources used under each charge 
number/project number combination. Whenever a new CHARGE statement. is issued, 
the SRU information for the previous charge number /project number is written to the 
account dayfile and then cleared. However, the other accumulators (central processor 
time, mass storage activity, and so on) are not cleared but continue to increment. 
The following message is also issued when a new CHARGE statement is entered. 

yy. mm. dd. hh. mm. ss. jobname. ACCN, chargenum, projectnum. 

For a complete list of messages issued to the user's dayfile, refer to Job Completion, 
section 3. 
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COMMENT STATEMENT 

The COMMENT statement is used to enter the specified comment in the system and user's 
dayfile. 

The control statement format is: 
COMMENT, comments or 
^comments 

comments Any combination of characters the user wishes to display 

If the 

^comment 
format is used, the * must appear in column 1. 

CTIME STATEMENT 

The CTIME control statement requests that the accumulated CPU time for the job be issued 
to the user's dayfile (in seconds). 

The control statement format is: 
CTIME. 

DAYFILE STATEMENT 

The DAYFILE control statement causes the system to write the user's control point 
dayfile to the' file specified. 

The control statement format is: 

DAYFILE(lfn, strng, op, pd, pi) 

or 
DAYFILE(L=lfn, FR=strng,OP=op, PD=pd, PL=pl) 

L=lfn File on which the dayfile is to be written. If omitted, OUTPUT 

is assumed. Pagination will occur if listing file name is OUT- 
PUT or if PD or PL is specified. 

FR = strng This parameter specifies the literal string for which a search 

is to be made in the dayfile. Unless the literal string is a 
valid command or control statement (seven characters or less), 
it must be enclosed by $ delimiters. The first character of the 
literal string requested must always be the starting position of 
the field (for example, the first character of the time field is a 
space). The field to be searched is specified by the op param- 
eter. The portion of the dayfile from the last occurrence of 
the requested literal string to the end of the dayfile is returned 
to the user. 
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OP=op Selects search option (single character): 

op 

T Search time field for matching string 

M Search message field for matching string 

I Incremental dump (from point of last dump) 

F Full dump 

If a literal string (strng) is specified and op is omitted, OP=M 
is assumed; if both strng and op are omitted, OP=F is assumed. 

PD=pd Print density (3, 4, 6, or 8 lines per inch): if omitted, PD=6 

is assumed. 

PL=pl Selects page size; if omitted, page size is determined from 

print density. Page size does not include title lines. 

PD Assumed PL 

3 30 

4 40 
6 60 
8 80 

Examples: 

DAYFILE(TEMP, $ABCDEFG$) 

DAYFILE(L=TEMP,FR=$ABCDEFG$ # OP=M) 

DAYFILE(FR=COMPASS) 



ENQUIRE STATEMENT 

The ENQUIRE control statement gives information about the system to the user. Three 
forms of the command are allowed. 

The control statement formats are: 

ENQUIRE (OP=P!P 2 . . . p n » JN=jobname, FN=lfni, 0=lfn 2 ) 

or 
ENQUIRE( Pl p 2 ...p n ) 

or 
ENQUIRE. 

p. Any of the following options. 

Option Description 

A Gives listings of the B, D, R, U, J, L, and F 

options, respectively. 
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Option 



Description 



B 



Returns to the user identification and priority infor- 
mation. 



D 



Example: 



USER NUMBER 
USER INDEX HASH 
JOB NAME 
JOB SEQ.NO. 
FAMILY 
PACKNAME 
PRIMARY FILE 
SUB SYSTEM 
QUEUE PRIORITY 
CPU PRIORITY 
MAX FL (CM) 
MAX FL (EC) 
LAST FL (CM) 
LAST FL (EC) 



DLH2500 

AKQA 

AKQAAEF 

AAEF 

CLS127 

*NONE*. 

*NONE*. 

NULL. 

4010 

30 

203700 









Returns a listing of the resources the user has 
demanded and those which have been assigned. 

Example: 

RESOURCE DEMAND INFORMATION. 

RESOURCE DEMAND ASSIGNED 

MT 2 2 

Gives the status of files at the user's control point. 
Example: 

LENGTH/ PRUS 



FILENAME 

EXAMP 
INPUT 
B FILE 3 
OUTPUT 

TOTAL = 4 



2 

3 

21 

3 



TYPE 


STATUS 


LO. 

IN. * 

LO. 

PR. 


EOR READ 
EOR READ 
EOR READ 
I/C WRITE 



Returns the contents of the user's control registers, 
error flag field, and succeeding control statements. 

Example: 

JOB CONTROL REGISTERS. 

Rl = 32 
R2 = 98 
R3 = 

EF= 

CONTROL STATEMEJSTT(S). 

GET(ALPHA) 
COPYSBF(ALPHA, ) 
*EOR* 
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Option Description 

L Returns user's loader information. 

Example : 

LOADER INFORMATION. 
MAP OPTIONS = SBX 
GLOBAL LIBRARY SET IS - 

EMPTY. 

R Returns to the user the amount of resources used. 

These statistics are factors that make up the SRU. 

Example : 

RESOURCES USED. 

CPU TIME 0.025 SECS. 

MS ACTIVITY 0.117 KUNS. 

MT ACTIVITY 0.000 KUNS. 

PF ACTIVITY 0.010 KUNS. 

ADDER 0.002 KUNS. 

SRU 2.025 UNTS. 

S Returns the user's accumulated SRUs. The SRU 

represents the total usage of the system by the user 
This unit is derived from central processor' time, 
I/O activity, and memory usage. 

Example: 

SRU ACCUMULATOR. 

SRU 2.030 UNTS. 

T Returns accumulated CPU time. 

Example: 

CPU ACCUMULATOR. 

CPU TIME 0.017 SECS. 

U Returns the amount of resources still available to 

the user. 

Example i 

RESOURCE USAGE ALLOWED. 

SECONDS 64 

JOB STEP SRU 128 

ACCOUNT BLK SRU 640 

DAY FILE MESSAGES 462 

CONTROL STATMTS 458 

DISPOSE FILES 4 

MASS STORAGE 12586 
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Option Description 

jobname Last three characters of the name assigned by the 

system to a remote batch job that has been initiated 
with the SUBMIT, ROUTE, or LDI statement. When 
this parameter is specified, the status of the remote 
batch job is returned. If JN (without =jobname) is 
specified, the status of all jobs associated with the 
current user number that are active in the system 
is returned. It is only possible to obtain the status 
of jobs submitted under the current user number. 

Ifni Local file name. When this parameter is specified, 

the status of the particular file is returned in the 
same manner as when the F option is specified. 

Ifti2 Name of alternate file to receive output. If omitted, 

the system assumes OUTPUT. 

The third form of the statement (ENQUIRE. ) defaults to the OP=A option. All OP= 
options (except S and T) are executed and the information is printed on the OUTPUT 
file. 

EXIT STATEMENT 

The EXIT control statement indicates the position in the control statement record where 
processing will resume if an error is encountered or where to terminate normal con- 
trol statement processing if an error is not encountered. For additional information, 
refer to the description of the NOEXIT and ONEXIT controls tatements later in this 
section and to the description of exit processing in section 5. 

The control statement format is: 

EXIT. 

LDI STATEMENT 

The LDI routine copies lfn to mass storage and submits the job(s) to the input queue 
with IDs to identify each job. The -copy begins at the current position of the file 
pointer and coniunues until an EOI or double EOF is encountered. The jobs submitted 
are gatch origin type jobs. 

The control statement format is: 

LDI(ifn,id,m) 

lfn Name of file containing the job(s) to be submitted; if lfn is 

omitted, LOAD is assumed. 

id Identification code (0 through 67s and 77s); if omitted, is 

assumed. If an id of 77 g is assigned, the OUTPUT file will 
be released at job completion. 

m Job names of jobs loaded are listed in the dayfile for the 

control point; if omitted, the list is suppressed. 
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The user can submit only the number of jobs for which he is validated (refer to the 
DB field description for the LIMITS control statement in this section). If this limit is 
exceeded, no further jobs are loaded, and the following message is issued to the dayfile. 

TOO MANY DEFERRED BATCH JOBS. 

If the submitted job contains an illegal USER statement, the job entering the LDI state- 
ment is aborted (no exit processing), and the following messages are issued to the 
dayfile. 

ILLEGAL USER CARD. 
SYSTEM ABORT. 

In addition, the following message is issued to the account dayfile. 

SIUN, usernum. 

Terminal users will be immediately logged off with no dayfile message. The security 
count for the user number that entered the LDI statement is decremented accordingly. 



LENGTH STATEMENT 

The LENGTH control statement gives the user the current status of one of his local files. 

The control statement format is: 
LENGTH(lfn) 

lfn Name of local file 

| The information given for the local file includes its length in PRUs, type, and current 
status. 

LIMITS STATEMENT 

The LIMITS control statement directs the system to list validation information on file OUT- 
PUT for the user named on the latest USER statement. 

The control statement format is: 
LIMITS. 

Generally, validation limits are the internal system controls associated with each user 
number which govern his use of certain system resources. The listing provided describes 
both the resources available to the user and the extent to which they may be used. All 
numeric values listed are decimal unless the postradix B appears, signifying an octal value. 
The following information is listed. 
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Field Description ... 

AB| Answerback identifier (1 to 10 alphanumeric characters) used for ter- 

minal identification 

MT Maximum number of magnetic tape units the user is allowed to have as- 

signed to his job concurrently 

RP Maximum number of removable auxiliary devices the user is allowed to 

have assigned to his job concurrently 

TL Maximum amount of central processor time (cumulative CPU time slices) 

in seconds allowed for each job step of the user's job. TL represents 
the actual time limit divided by 103 I 

CM Maximum number of central memory words that the user is allowed to re- 

quest. The value stored for CM represents the actual word limit divided 
by 100 8 . 

NF Maximum number of files that the user is allowed to have attached to a 

job concurrently 

DB Maximum number of deferred batch jobs that the user can have in the 

system concurrently 

If the user is validated for system privileges and DEBUG mode is set on 
the system display console or if the user is submitting jobs from system 
origin, this parameter is ignored. The user is allowed to submit as many 
jobs as desired. 

FC Maximum number of indirect access permanent files the user can have | 

in each catalog. This limit applies to each catalog being accessed (main, 
public auxiliary, or private auxiliary). 

CS Maximum number 01 PRUs available to the user for indirect access files 

FS Maximum number of PRUs available to the user for any one indirect ac- 

cess file 

PA t Terminal parity (EVEN or ODD) 

RO| Specifies the number of rubout characters required for carriage return 

delay 

PXf FULL or HALF duplex transmission mode 

TT| Terminal type 

TC| Character set to be used by time-sharing terminal 

IS| Initial subsystem for time-sharing terminal 

MS Maximum number of mass storage PRUs the user is allowed to additionally 

allocate via his job 

DF Maximum number of MESSAGE requests the user can issue to the system 

and/ or job dayfiles 

CC Maximum number of batch control statements processed for a user. 

(Time-sharing processed control statements are excluded. ) 

OF Maximum number of print and punch files the user can dispose to output 

queues 

CP Maximum number of cards that can be punched from a user's 

punch file 

LP Maximum number of lines that can be printed from a user's 

print file 



|For further information about this field, refer to the Time -Sharing User's Reference 
Manual. 
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Field Description 

EC t Maximum number of ECS memory words that the user is allowed to re- 

quest 

SL Maximum number of SRUs the user is allowed for a job 

CN Charge number to which the user is assigned 

PN Project number to which the user is assigned 

DS Maximum number of PRUs available to the user for any one direct access 

permanent file 

AW Access word; controls the user's access within the system according to 

the following options (assumed values are options 1, 3, and 4). 

Option Specifies 



1 User can change his password. 

2 User can use the privileged time-sharing commands, f t 

3 User is allowed to create direct access files. 

4 User is allowed to create indirect access files. 

5 User can have system origin (SYOT) capability from any job 
origin if the system console is in DEBUG mode. 

The user is allowed to assign a device by its EST. ordinal 
although the system need not be in DEBUG mode to do so. 

The user is allowed to call the customer engineering PPU- 
based diagnostics if ENGINEERING mode (ENGR) is set at 
the system console. 

6 User can access/create library files. 

7 User can assign nonallocatable devices. A nonallocatable 
device is a magnetic tape unit, card reader, card punch, 
or line printer. Refer to File Management Control State- 
ments in section 7 for further information. 

8 User is allowed to access the system without supplying his 
assigned charge and project numbers. 

9 User can define, save, and replace files on auxiliary devices, 

10 User can access special transaction functions. 

11 Allows no terminal timeout. 

12 User has special accounting privileges. |tt 

13 Allows use of the system control point (SCP) facility. 

The octal value listed for AW corresponds to the preceding options where 
bit is option 1, bit 1 is option 2, and so on. For example, if the access 
word listed were: • 

AW^00000000000000000215 

the user would be validated for options 1, 3, 4, and 8. 



tNot currently used by the system but provided for future expansion of validation control. 
t tF°r further information about privileged time-sharing commands, refer to the operator's 
guide. 

If | tRefer to part IV, section 1 of the NOS Installation Handbook for a description of 
special user's accounting privileges. 
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The LIMITS statement is equivalent to the OP=I option of MODVAL. If. any parameters are 
included on the LIMITS statement, the system issues the following message to the user's 
dayfile. 

ERROR IN LIMITS ARGUMENTS. 

MFL STATEMENT 

The MFL control statement resets the maximum field length for a job step. The control 
statement format is: 

MFL(nnnnnn) 

nnnnnn Field length (octal) 

The parameter nnnnnn sets an upper bound for the field length of subsequent job steps. The 
value cannot exceed the maximum field length for the job nor can it be less than the field 
length required by the utility (CONTROL) that processes MFL. The field length required by 
CONTROL is 40 OB. 

The MFL control statement clears any initial running field length previously established with 
the RFL control statement or the SETRFL macro and allows the system to determine the 
field length for each succeeding job step. The system will continue to determine field lengths 
until another RFL control statement or SETRFL macro is encountered. 

MODE STATEMENT 

The control statement format is: 

MODE(m, n) 

m CPU program error exit mode (0<m<7) 

nt CPU hardware error exit mode (0<n<7) 



t Applicable to CDC CYBER 170 series only. 
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The following values can be supplied for m. 

m CPU Program Error Exit Mode 

Disable program exit mode; no selection made 

1 Address out of range because: 

• Attempt was made to reference CM or ECS out-i 
side established limits, or 

• Attempt was made to reference last 60- bit word 
(word 7) in relative address FL of ECS. 

2 Operand out of range; floating-point arithmetic unit re- 
ceived an infinite operand 

3 Address or operand out of range 

4 Indefinite operand; floating-point arithmetic unit received 

an indefinite operand 

5 Indefinite operand or address out of range 

6 Indefinite operand or operand out of range 

7 Indefinite operand, operand out of range, or address out 

of range. If no mode is selected, the system assumes 
m=7. 

The following values can be supplied for n. 

_n CPU Hardware Error Exit Mode 

Disable hardware exit mode; no selection made 

1 ECS flag register operation parity error 

2 CMC input error 

3 ECS flag register operation parity error or CMC input 

error 

4 CM data error 

5 ECS flag register operation parity error or CM data 

error 

6 CMC input error or CM data error 

7 ECS flag register operation parity error, CMC input 

error or CM data error. If no n mode is selected, the 
system assumes n=7. 

It is recommended that the user always specify n=7. If any hardware exits occur, he 
should contact a customer engineer or on-site analyst. 

The MODE statement is used to define the error conditions that cause the system to exit 
from normal processing. When the specified error occurs, the system sets the appro- 
priate error flag and exits from normal processing to perform any error processing 
required. If an error occurs for which the exit mode is not selected, the system 
notes the error, skips the operation that is causing the error, and continues normal 
processing. Note that if exit mode 3, 5, 6, or 7 is specified, a combination of exit 
modes 1, 2, and 4 is actually selected. For example, if exit mode 5 is specified, an 
error exit will occur for either a mode 1 or mode 4 error condition. Refer to Error 
Control, section 3 and to the CDC CYBER 170, CYBER 70, and 6000 Series Computer 
Systems Reference Manuals for further information about the processing of mode errors. 
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NOEXIT STATEMENT 

The NOEXIT control statement suppresses the transfer of control to the statement following 
the next EXIT statement if an error occurs. 

The control statement format is: 
NOEXIT. 

If a NOEXIT statement has appeared in the control statement record and an error 
occurs, processing continues with the next control statement, if possible (that is, if 
error does not cause job to abort). Refer to the description of exit processing in 
section 5 for further information. 

NORERUN STATEMENT 

The NORERUN control statement allows a user to clear job rerun status. 

The control statement format is: 
NORERUN. 

If the NORERUN statement has been issued, the job may not be rerun. This may be 
desirable to prevent updating of an important data base when the job would otherwise 
be rerun. 

This statement is ignored from a time -sharing origin job. 

OFFSW STATEMENT 

The OFFSW control statement clears the pseudo-sense switches for reference by the user's 
program. 

The control statement format is: 
OFFSW(s p s 2 , ...,s n ) 

s^ Sense switch to be cleared; l<Si<6. If Si=0 is specified, 

all sense switches are cleared". ~" 

The system stores the sense switch settings in the user's control point area and copies 
them to RA for use by the central program. The system operator can change these 
settings by console command. 

ONEXIT STATEMENT 

The ONEXIT control statement causes the transfer of control to the statement following the 
next EXIT statement if an error occurs. 

The control statement format is: 
ONEXIT. 

The ONEXIT statement reverses the effect of a NOEXIT statement. If an error occurs 
in processing a statement following ONEXIT, control transfers to the statement follow- 
ing the next EXIT statement. Refer to the description of exit processing in section 5 
for further information. 
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ONSW STATEMENT 

The ONSW control statement sets the pseudo-sense switches for reference by the user's 
program. 

The control statement format is: 
ONSW(s lf s 2 ,...,s n ) 

Sj Sense switch to be set; l<J3i<6. If s^O is specified, all 

sense switches are set. 

The system stores the sense switch settings in the control point area and copies them 
to RA for use by the central program. The system operator can change these settings 
by console command. 

PASSWOR STATEMENT 

The PASSWOR control statement is used to change the user's password. 

The control statement format is: 

PASSWOR(oldpswd, newpswd) 

oldpswd Old password 

newpswd New password 

For added security, the user may issue the PASSWOR statement without parameters. In this 
case, the system will read the parameters from a record in the INPUT file. This record 
must be a single line with the format: 

oldpswd, newpswd 

The user's password is changed from oldpswd to newpswd. The user can change his 
password only if access option 1 is set (refer to the LIMITS control statement in this 
section). If option 1 is not set and the user submits a PASSWOR statement, the system 
issues the following message to his dayfile. 

ILLEGAL CONTROL CARD. 

If the control statement parameters are in error, the system issues the following message. 

ERROR IN PASSWOR ARGUMENTS. 

If the installation is currently updating the validation file or another user is modifying 
his password, a nontime- sharing origin job is rolled out until the validation file is 
available. A time- sharing origin PASSWOR command will be aborted with the message: 

MODVAL ABORTED. 

If this situation is encountered, the time- sharing user should be able to retry his 
password change within a short time. 

RERUN STATEMENT 

The RERUN control statement allows a user to set job rerun status. 

The control statement format is: 
RERUN. 

If the RERUN statement has been issued, the job may be rerun. This statement is 
ignored from a time -sharing origin job. 
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RESOURC STATEMENT 

The RESOURC control statement is necessary in any job that uses more than one tape or 
pack concurrently in order to prevent deadlocks with other jobs which may need the 
same resources. 

The control statement format is: 

RESOURC(rt =u.,,rt =u ,.. ,,rt =u ) 
l l & & n n 

rt. Resource type: 

MT Magnetic Tape Unit (7-track) 

NT Magnetic Tape Unit (9 -track) 

Dli 844-21 Disk Storage Subsystem (l<i<8) 

DJi 844-41/44 Disk Storage Subsystem (1< i<, 8) | 

MDi 841 Multiple Disk Drive (l<i<8) 

u. Maximum number of units of resource type rt^ this job will 

1 use concurrently; any rt^=u^ entry can be changed on sub- 

sequent RESOURC control statements. 

The system manages the use of tape units and disk packs in such a way as to prevent 
deadlocks from occurring. A deadlock would occur if the system, by assigning a tape 
unit or pack to one job, prevented another job with currently assigned resources from 
completing. For example, an installation with two tape units is processing jobs A 
and B. Each job needs both units during some phase of processing. Job A is assigned 
unit 1. If job B were assigned unit 2, neither A nor B could complete until the other 
job relinquished its assigned unit. 

The system prevents such situations by requiring that a RESOURC control statement be 
included in any job that uses more than one tape or pack concurrently. When a job 
that includes a RESOURC statement is submitted, the system first checks if the specified 
number of units exceeds the number of units for which the user is validated) or the 
number of units available at the installation. If either of these situations occurs, the 
system issues an error message to the user's dayfile and aborts the job. 

When the job requests a tape or pack, ff~ the system compares the number of units that 
jobs being processed have scheduled via RESOURC statements with the number of units 
actually assigned. If it determines that the assignment would cause a deadlock, it rolls 
out the job until a deadlock would not occur. If the assignment would not cause a dead- 
lock, the system searches for the requested tape or pack. If found, it is assigned to 
the requesting job. If the pack is not found and the NA keyword was included in the 
request or if the tape is not found, the requesting job is rolled out until the operator 
makes the pack or tape available. 

Thus, in the previous example, a RESOURC statement would be required in both jobs. 
The information supplied by the statements would enable the system to anticipate the 
deadlock situation and roll out job B until job A no longer needed both units. 



t For jobs that use only one tape or pack at a time and do not contain a RESOURC 
statement, the system checks validation limits when the request is made. 

ft Refer to Permanent File Control Statements, section 8 for a description of disk pack 
requests and to Tape Management Control Statements, section 10 for a description of 
tape requests. 
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Under certain conditions the system over commits resources, provided all jobs with 
currently assigned resources can complete. For example, an installation with three 
tape units is processing jobs A and B. Included in each job is a RESOURC statement 
scheduling two units. Job A requests its first tape. It is assigned the tape (unit 1) 
because there are enough units available for job A to complete. Job B requests its 
first tape. It is assigned the tape (unit 2) because either A or B can complete if 
assigned the last unit, t.nd when the job that is assigned the last unit completes, the 
other can then use that unit and also complete. Job B then requests and is assigned 
its second tape (unit 3). It completes its operations (that is, terminates or returns 
the files on the tape) and makes the unit available for job A to complete. 

The system manages resources by keeping totals of the number of scheduled units and 
assigned units. Each total can vary during job processing. A user can increase the 
number of scheduled units by returning all files attached to his job residing on re- 
source units not currently needed and then scheduling the required number of units 
with another RESOURC statement. He can decrease the number of scheduled units by 
including RETURN statements or additional RESOURC statements. 



In the following job, for example, the second RESOURC statement increases the number of 
scheduled disk drives and decreases the number of scheduled tape units. 

SAMSJOB(CM50000, T40) 

USER( SJGREEN, WGT, ALTFAM) 



CHARGE(D593) 
RESOURC (NT =2) 



RESOURC(MDl=2,NT = l) 



-EOI- 



At some time during this phase of processing, 
the job will require two 9-track tape units. 



During this phase, the job will require two 841 
Multiple Disk Drives and one 9-track tape unit. 
The NT = 1 entry decreases the number of scheduled 
tape units from two to one. 



If the user decreases the total to less than the number of currently assigned units or 
increases the total to a point where a deadlock would occur, the system issues an 
error message to the user*s dayfile and aborts his job. 

| NOTE | 

In a multimainframe environ- 
ment, only the configuration 
of the machine on which the 
job is processed is consid- 
ered in the overcommitment 
algorithm. 
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The method of assigning units depends on the resource type. For example, all tapes 
and all private disk packs not accessible by alternate users can only be assigned to 
one job at a time. All public packs and those priv.\.e packs accessible by alternate 
users are sharable, and therefore, can be assigned to several jobs at the same time. 

On indirect access file requests the pack is charged to the job in fulfilling its resource 
demand only if the request causes the pack to be mounted. For direct access file re- 
quests, the pack is charged to the job when the first ATTACH of a direct access file 
is made. 

A unit is assigned to a job until the job terminates or all direct access files residing 
on the unit that are assigned to the job are returned. At this point a tape or a non- 
sharable pack can be dismounted. A sharable pack, however, can be dismounted only 
when there are no files residing on the unit that are assigned to any of the jobs sharing 
the pack. 



NOTE 



In GET requests for indirect access files, a pack is 
assigned to a job only as long as the pack is actually 
being used (that is, until the system retrieves the local 
copy of the file). Therefore, during a series of GET 
requests, the operator may determine that the pack is 
not being used and dismount it. If the user has a direct 
access file on the pack, he can avoid this situation by 
attaching the direct access file before issuing the GET 
requests. 

A single job cannot have more than 36 removable pack devices attached to the job 
concurrently. 

RFL STATEMENT 

The RFL control statement sets the initial running field length for a job step when neither I 
the routine for processing that step nor a loader table specifies a field length. I 

The control statement format is: 

RFL(nnnnnn) 

nnnnnn Field length (unless decimal is specified, octal is assumed) 

If the field length is specified in decimal (number contains an 8 or 9 or has a post- 
radix of D), it is converted to octal and rounded up to the nearest 100 ft . The value of 
nnnnnn cannot exceed the value specified on the last MFL control statement or the 
maximum allowed for the job. 

Prior to the appearance of the RFL control statement (or SETRFL macro), the system 
determines the field length for each job step, provided no field length is specified by a 
system routine or loader table (refer to Job Control, section 3). 
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ROLLOUT STATEMENT 

The ROLLOUT control statement requests that the user's job be rolled out and all memory 
assigned to the job released. 

The control statement format is: 
ROLLOUT. 

The user's job is entered into the rollout queue and is rescheduled by the system. 

RTIME STATEMENT 

The RTIME control statement requests that the time be read from the real-time clock 
and issued to the dayfile (in seconds). This is the accumulated time since the last 
system deadstart. 

The control statement format is: 
RTIME. 

SETASL STATEMENT 

The SETASL control statement allows the user to specify a new account block SRU limit. 

The control statement format is: 

SETASL(s) 

s Account block SRU limit in units (maximum is 77777«, 

which is infinite) 

The account block SRU limit is the number of SRUs that may be accumulated by the job 
before the system issues the error message: 

ACCOUNT BLOCK LIMIT. 

Each user and charge /project number is validated for a maximum SRU limit. If the 
user attempts to set the account block SRU limit above this limit, the following mes- 
sage is issued. 

SL NOT VALIDATED. 

If 1< s< 77777 R is not satisfied, the following message is issued. 

ILLEGAL USER ACCESS. 

The parameter s represents the maximum SRU accumulation between CHARGE statements 
or between one CHARGE statement and the end of the job. If a CHARGE statement is not 
required, s represents the maximum SRU accumulation from the USER statement to the 
end of the job. 

The user may not set the account block SRU limit to a value less than the current job step 
SRU limit. An attempt to do so will result in the message: 

JOB STEP EXCEEDS ACCOUNT BLOCK. 
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SETCORE STATEMENT 

The SETCORE control statement presets each word within the field length. 

The control statement format is: 

SETCORE(p) 

or 

SETCORE(-p) 

p Any of the following: (If a minus sign precedes the parameter p, 

the complement of p is set in core. ) 

p Fill Characters 



ZERO Zeros (0) 

INDEF Indefinite (1777 0000 0000 0000 0000) 

INF Infinite (3777 0000 0000 0000 0000) 

Each word within the field length is set to p. If p is omitted, the system assumes 
p=0. 



SETJSL STATEMENT 

The SETJSL control statement allows the user to specify the job step SRU limit for each 
remaining step of his job. 

The control statement format is: 

SETJSL(s) 

s Job step SRU limit in units (maximum is 

77777 g , which is infinite) 

The job step SRU limit is the number of SRUs that may be accumulated by a single job 
step before the system issues the error message: 

JOB STEP LIMIT. 

The job step SRU limit may not exceed the account block SRU limit (the number of 
SRUs which may be accumulated by the job). If this is attempted, the following message 
is issued. 

JOB STEP EXCEEDS ACCOUNT BLOCK. 

If 1^ s< 77777g is not satisfied, the following message is issued. 

ILLEGAL USER ACCESS. 
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SETPR STATEMENT 

The SETPR control statement allows the user to specify. a new CPU priority for his job. 

The control statement format is: 

SETPR(p) 

p Priority, l<p<70g; if p exceeds that for which the user 

is validated, nT is reduced to that value. 

The CPU priority controls the assignment of the CPU to active jobs. If the CPU 
priority is lower than that of other jobs, the job is assigned to the CPU only when 
jobs of a higher priority do not need it. The user is validated for a maximum CPU 
priority. He cannot request a level that exceeds this value or 7 Og (the maximum 
CPU priority). 

SETTL STATEMENT 

The SETTL control statement allows the user to specify a new CPU time limit for 
| subsequent job steps. 

The control statement format is: 

SETTL(t) 

t Central processor job step time limit in octal seconds 

(maximum is 77777 g ); t is accurate to the nearest second. 
If an 8 or 9 appears in the specification, it is interpreted 
as decimal. 

The CPU time limit is the amount of time (in seconds) that a job step is allowed to use 
the CPU before the error message 

TIME LIMIT. 

is issued by the system. 

The user is validated for a maximum job step time limit. If this is exceeded or 
1< t< 77777 g is not satisfied, the following message is issued. 

TL NOT VALIDATED. 

If t is between 77770 g and 77777 g , the time limit is infinite. The user cannot set a 
time limit greater than that for which he is validated. 

STIME STATEMENT 

The STIME control statement requests that the accumulated SRU value for the job be 
issued to the user's dayfile. 

The control statement format is: 
STIME. 
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SUBMIT STATEMENT 

The control statement format is: 

SUBMIT(lfn, q, NR)c 

lfn Name of the file to be submitted to the system for 

processing as a batch job 

q Specifies disposition of job output as follows: 

B Job output is disposed to local batch queue to be 
printed and/ or punched at the central site (default 
value for nontime -sharing origin jobs) 

N Job output is disposed to local batch queue, but 
is dropped at job termination (default value for 
time -sharing origin jobs) 

E Job output is disposed to Export/Import queue for 

printing at a remote batch terminal 

NR No rewind option; inhibits rewind of file specified by re- 

formatting directive cREAD. If omitted, file specified by 
cREAD directive is automatically rewound. 

c Escape character used to identify reformatting directives 

in the file to be submitted (lfn). If omitted, the system 
assumes c=/. 

The submit file lfn contains a batch job submitted to the system for processing. The 
reformatting directives described in this section are provided to aid the user in pre- 
paring the submit file. When the SUBMIT statement is processed, the submit file can be 
reformatted according to the directives that appear in the file. 

The number of jobs that the user can have in the system concurrently is dependent on 
the individual validation limit (refer to the DB field of the LIMITS control statement in 
this section). If this limit is exceeded, the following message is issued to his dayfile. 

TOO MANY DEFERRED BATCH JOBS. 

Each line in the submit file preceded by an escape character is recognized by the 
system as a reformatting directive. The escape character to be used must be specified 
on the SUBMIT statement (/ by default). Throughout this description, the letter c, 
preceding a directive, denotes the escape character. Reformatting directives may be 
interspersed throughout the submit file as long as transparent mode is not in effect. 
Transparent mode is selected by the cTRANS directive and requires that the user 
observe special rules when inserting subsequent directives into the file (refer to 
description of cTRANS and cNOTRANS directives). 

The system does not process reformatting directives unless the first line of the submit 
file contains the cJOB directive. In addition, the first two statements following the 
cJOB directive (second and third statements of the submit file) must be a job and 
USER statement, respectively. All following information is determined by the user. Thus, 
the first three lines of a submit file that is to be reformatted before processing should be 

lnl cJOB 

ln2 jobname, ... 

In3 USER, . . . 

where lnl, ln2, and ln3 are optional line numbers. 
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The SEQ and NOSEQ directives are used to determine, during reformatting, if the submit 
file will contain leading line numbers. Therefore, it is a simple matter to include line 
numbers on the entire submit file and specify which line numbers are to be removed 
during reformatting. This is especially useful if the submit file contains a BASIC program 
where line numbers are a requirement of the language. 

The reformatting directives available are described as follows: 

cJOB Indicates that the submit file is to be reformatted and 

selects the following default reformatting directives. The 
default directives remain in effect until specified otherwise. 

cNOTRANS (disabled by cTRANS) 

cSEQ (disabled by cNOSEQ) 

cPACK (disabled by cNOPACK) 

The cJOB directive must be the first line of the submit file. 
If omitted, the file is not reformatted. 



cEOR 

cEOF 

cSEQ 

cNOSEQ 

cPACK 

cNOPACK 
cTRANS 



Indicates that an end-of-record mark is to be placed at 
this point in the submit file during reformatting. 

Indicates that an end-of-file mark is to be placed at this 
point in the submit file during reformatting. 

Indicates that the following lines are preceded by line 
numbers and requests that they be removed (default value). 

Reverses the effect of the cSEQ directive. No attempt is 
made to remove leading line numbers from subsequent lines. 

Requests that all succeeding end-of-record and end-of-file 
marks be removed (default value). This directive applies 
only to internal EOR and EOF marks that currently exist. 
The cEOR and cEOF reformatting directives are not affected. 

Reverses the effect of the cPACK directive. Requests the 
system not to discard succeeding internal end-of-record and 
end-of-file marks that currently exist. 

Indicates transparent mode. When the system encounters this 
directive, it checks the next line of the submit file for an 
additional directive. If one exists, it is processed and the 
next line is checked. This continues until a line that is not 
a reformatting directive is encountered. Transparent mode 
is then selected and all directives that exist on subsequent 
lines are ignored until an internal EOR or EOF is encountered 
(this pertains only to EOR and EOF marks that currently 
exist, not cEOR and cEOF directives). The cPACK and 
cNOPACK directives determine if the internal EOR or EOF 
mark will be retained. The line following the internal EOR 
or EOF mark is then checked for a reformatting directive. 
If one exists, it is processed and the following line is checked, 
All directives are processed until a line that does not con- 
tain a reformatting directive is encountered. This causes 
transparent mode to be reset unless a cNOTRANS directive 
was encountered. This process continues until either the end 
of the submit file is reached or until a cNOTRANS directive 
following an internal EOR or EOF is encountered. 
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The cTRANS directive is typically used in conjunction with 
the cREAD directive. It allows the user to copy the contents 
of an existing file into the submit file at the location of the 
cREAD directive. Because the file is read in transparent 
mode, no check for reformatting directives is attempted until 
an internal EOR or EOF is encountered. Note that the cREAD 
directive must follow the cTRANS directive and must be located 
before the first succeeding line that is not a reformatting di- 
rective. If not, transparent mode is selected before the cREAD 
directive is encountered and the cREAD will be ignored. 

The cSEQ or cNOSEQ directive in effect before transparent 
mode was selected has no effect upon the submit file or the 
file being read (cREAD) while transparent mode is in effect. 
Note, however, that the cPACK or cNOPACK directive in 
effect before transparent mode was selected remains in effect 
after it is selected. 



cNOTRANS 



Reverses the effect of the cTRANS directive and informs the 
system that the submit file is to be examined on a line-by-line 
basis. All directives encountered in the submit file while the 
cNOTRANS directive is in effect will be processed. This 
directive is initially selected by default and remains in effect 
until a cTRANS directive is encountered in the submit file. 



cREAD,lfn 



The user should be careful in placing this directive in the 
submit file. If transparent mode is selected, this directive 
can possibly be ignored unless it immediately follows either 
a cREAD directive in the submit file or an internal EOR or 
EOF mark. 

Requests that the system read the entire contents of the 
specified file, lfn, and insert that file in place of the cREAD 
directive in the submit file, during reformatting. If the file 
to be read is not currently local to the job, the system 
automatically attempts a GET and then an ATTACH on the 
file. If lfn is not specified in the directive, TAPE1 is 
assumed. If the file specified cannot be found, the message 

NO READ FILE - lfn. 

is issued to the user's dayfile, and the job is terminated. 
If the read file is found to be busy (direct access files only), 
the message 

READ FILE BUSY - lfn. 

is issued to the user's dayfile, and the job is terminated. The 
file specified by lfn in the cREAD directive is automatically 
rewound before the read operation unless the NR parameter is 
specified on the SUBMIT control statement. In this case, the 
rewind directive must precede the cREAD directive in the sub- 
mit file if it is desired to rewind file lfn before the read opera- 
tion begins. The system returns all files specified in cREAD 
directives before completion of the job. 

If the cPACK directive is in effect at the time of the read, 
all internal EOR and EOF marks will be removed. If the 
cNOPACK directive is in effect, all internal EOR and EOF 
marks are read into the submit file in the proper position 
during reformatting. 
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Unless transparent mode is in effect when file lfn is read, 
each line of that file will also be checked for a reformatting 
directive. Any directives contained in the file, except an- 
other cREAD, will be processed. The cREAD directive cannot 
be nested. In addition, any directives in effect before the 
cREAD directive is processed will remain in effect for the 
file being read, unless transparent mode is selected. Then, 
only the cPACK or cNOPACK directive remains in effect for 
the file being read. Moreover, only those directives that 
immediately follow an internal EOR or EOF in the file being 
read will be processed. 

If the file to be read is a binary file, it is recommended 
that the cTRANS directive be used. This is to ensure that 
binary data will not be mistaken for a reformatting directive. 
The cTRANS directive should immediately precede the cREAD 
directive in the submit file, if used. 

cREWIND,lfn Requests that the system rewind file lfn to the beginning-of- 

information (BOI). If lfn is not supplied, TAPE1 is assumed. 
This directive is required only if the NR parameter is in- 
cluded in the SUBMIT command. Otherwise, file lfn is auto- 
matically rewound. 

This directive is used in conjunction with the cREAD directive. 
Thus, if it is desired to rewind a file before the read operation 
begins, this directive must precede the cREAD directive in 
the submit file. 

c^EC=C2 Indicates that the escape code character is to be changed 

from c.. (current escape code) to C2 (new escape code). The 
new escape code will be used to recognize all subsequent 
reformatting directives until further change. 

There is no restriction on the maximum number of characters per line for transparent 
mode. For all other modes, no line can exceed 150 (6 -bit) characters. 

If the user determines that an error occurred during processing of his job, he may 
reference a listing of the user's dayfile as an aid in identifying the cause of the error. 
The user's dayfile contains a record of the job processing activity and is disposed to 
the local batch queue or the Export/Import queue for printing when the job is terminated. 
However, all output is normally dropped at job termination when a batch job image is 
submitted from a time-sharing terminal. This includes the dayfile output as well as the 
job output. In this event, the user can make provisions within his job to save the con- 
tents of the dayfile if an error in processing occurs. This is done by including the 
following control statements at the end of the control statement record. 



lnx 


EXIT. 


lny 


DAYFILE(lfn) 


lnz 


REPLACE(lfn) 



If the submitted job contains an illegal USER statement, the job entering the SUBMIT 
statement is aborted (no exit processing), and the following messages are issued to 
the dayfile. 

ILLEGAL USER CARD. 
SYSTEM ABORT 
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The security count for the user number that entered the SUBMIT statement will be 
decremented accordingly. 

In addition, the following message is issued to the account dayfile. 

SIUN, usernum. 

Terminal users will be immediately logged off with no dayfile message. For further 
information concerning use of the SUBMIT statement from a time-sharing terminal, 
refer to the Time-Sharing User's Reference Manual. 

SUI STATEMENT 

The SUI control statement allows a user to access a permanent file catalog without using 
the USER statement* 

The control statement format is: 
SUI(n) 

n User index desired; 0<n<377777 8 . 

The SUI statement is useful if validation is not active. Only system origin jobs may issue 
this control statement. If the job is not of system origin, the following message is issued. 

CPM ILLEGAL REQUEST. 

SUMMARY STATEMENT 

The SUMMARY control statement gives information about the system to the user. 
Three forms of the command are allowed. 

The control statement formats are: 

SUMMARY(OP=p 1 P 2 . . . P n * JN=jobname, FN=lfni, 0=lfn 2 ) 

or 
SUMMARY(p 1 p 2 . . . P n ) 

or 
SUMMARY. 

The parameters and function of this control statement are identical with the ENQUIRE 
statement described in this section, except that the third form of the statement 
(SUMMARY.) defaults to the OP=R option. 
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SWITCH STATEMENT 

The SWITCH control statement sets the pseudo-sense switches for reference by the user's 
program. 

The control statement format is: 

SWITCH(s 1 , s 2 , ...,s n ) 

Si Sense switch to be set; 1<sj<_6. If si=0 is specified, all 

sense switches are set. 

The system stores the sense switch settings in the control point area and copies them 
to RA for use by the central program. The system operator can change these settings 
by console command. 

This control statement/ performs the same function as the ONSW control statement. 

USECPU STATEMENT 

The USECPU control statement specifies which central processor is to be used when more 
than one is available for processing. 

The control statement format is: 

USECPU(n) 

n = Either central processor is used, 

n = 1 CPU is used, 

n = 2 CPU 1 is used. 

The USECPU statement may be used only when the system is running on a CDC CYBER 
73-2x, 74-2x, 6500, 6700, or CDC CYBER 174 system. On a 74-2x or 6700, CPU is 
the parallel processor, and CPU 1 is the serial processor. On the other systems, both 
CPUs are serial processors. This statement is ignored on single CPU machines. 
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USER STATEMENT 

The system utilizes the USER control statement to determine if the programmer is a 
legal user, which resources he is validated to use, and the extent (limits) to which he 
may use those resources. Comment statements are not. allowed between the job and 
USER statements of jobs entering the system via an LDI or SUBMIT statement. If this 
is attempted, the first comment statement is interpreted as an illegal USER statement 
and the submitting job is aborted with appropriate messages to the dayfile. The submitted 
job is dropped. 

The control statement format is: 

USER(usernum, passwrd, familyname) 

usernum A 1- to 7 -character alphanumeric user number 

passwrd A 1- to 7 -character alphanumeric password 

familyname Optional parameter identifying the family! of permanent 

file devices that have been or may be transferred from the 
user's normal system to a backup system 

This statement defines controls and validation limits for the job and defines the user's 
permanent file base. An installation may operate with secondary USER statements 
either enabled or disabled. If enabled, the user may specify a different permanent file 
catalog during job processing by issuing another USER statement. However, the access 
limits for the user named in the first USER statement remain in effect for all sub- 
sequent USER statements (refer to the LIMITS control statement in this section for in- 
formation concerning access limits). If secondary USER statements are disabled (de- 
fault mode) and a secondary USER statement is issued, the job is aborted (no exit 
processing). The security count for the current user number is decremented accordingly, 
and the following messages are issued to the dayfile. 

ILLEGAL USER CARD. 
SYSTEM ABORT. 

In addition, the following message is issued to the account dayfile. 

SIUN, usernum. 

The job will also be aborted, the security count decremented, and the preceding messages 
issued if an illegal or invalid USER statement is detected at any time, regardless of 
whether secondary USER statements are enabled or disabled. In all cases, terminal 
users will be immediately logged off with no dayfile message issued to the terminal. 

If the security count for the user number is exhausted, the system issues the following 
message. 

ILLEGAL USER NUMBER - CONTACT SITE OPR. 

When this occurs, the user number will be denied all access to the system until the 
security count has been reset by the installation personnel. 

Normally, the familyname parameter need not be included on the USER statement. 
However, if the user makes a practice of specifying his family name each time he 
submits a job, he can be sure that his job will be processed even if his normal sys- 
tem is not available and his permanent file family had to be moved to a backup system. 
If, after the first USER statement, the user does not specify a familyname on the USER 
statement, his permanent file family remains the same. If the user specifies the 
(zero) familyname, his permanent file family becomes the system default family. 



f Refer to section 2 for a description of permanent file devices. 
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Example : 

An installation has two systems, A and B. System B provides backup service for sys- 
tem A. The system default family name for system A is AFAM and the system de- 
fault family name for system B is BFAM. 

During normal operations, system A user CWJONES with password JPWD could enter 
either of the following USER statements. 

USER(CWJONES, JPWD) 

USER (CWJONES, JPWD, AFAM) 

System B user JDSMITH with password SPWD could enter either of the following state- 
ments. 

USER4JDSMITH, SPWD) 

USER (JDSMITH, SPWD, BFAM) 

If system A failed, user CWJONES would be required to enter 

USER (CWJONES, JPWD, AFAM) 

to identify his family of permanent file devices. User JDSMITH could enter either of 
the USER statements as before because the default family name would still be valid. 

If the user attempts to access permanent files on a device not present in the alternate 
system, one of the following messages is issued to the user's dayfile. 



DEVICE UNAVAILABLE, AT nnn. 



DIRECT ACCESS DEVICE ERROR, 
AT nnn. 



This message is issued if the user's 
master device! was not transferred to 
the backup system. 

This message is issued if the user 
attempted to reference direct access files 
on a device (other than his master de- 
vice) not present in the backup system, t 



t Refer to section 2 for a description of permanent file devices. 
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FILE MANAGEMENT CONTROL STATEMENTS 



The file management control statements enable the user to manipulate files attached to 
his job. The control statements included in this category are: 



ASSIGN 

BKSP 

CATALOG 

CLEAR 

COMMON 

CONVERT 

COPY 

COPYBF 

COPYBR 

COPYCF 

COPYCR 



COPYEI 

COPYSBF 

COPYX 

DISPOSE 

DOCMENT 

EVICT 

GTR 

LIBEDIT 

LIBGEN 

LIST80 

LOCK 

L072 



NEW 

OUT 

PACK 

PRIMARY 

RENAME 

REQUEST 

RESEQ 

RETURN 

REWIND 

ROUTE 

SETID 

SKIPEI 



SKIPF 

SKIPFB 

SKI PR 

SORT 

STAGE 

TDUMP 

UNLOAD 

UNLOCK 

VERIFY 

VFYLIB 

WRITEF 

WRITER 



I 



The statements in this section allow the user to position his files, copy data from one file 
to another, specify method and format of input/output, sort his files, and add correc- 
tions. He can assign his files to a specific device type; change the file type, identi- 
fication code, and write interlock status; and release them from job attachment. The 
user can also receive information about records in a file or documentation in a file 
containing COMPASS source code. 

If an error is encountered in an operation on one file of a multiple file request, the 
operation is not performed on the following files. For example, if an error occurs in 
processing file B on the following control statement: 

GET(A,B,C,D) 
files C and D are not processed. 

If a file is not specifically assigned through the use of an ASSIGN, LABEL, or 
REQUEST control statement, the system assigns the file to available mass storage. 
Refer to the ASSIGN and REQUEST statements in this section and Tape Management 
control statements in section 10 for a more detailed description. 
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ASSIGN STATEMENT 

The ASSIGN control statement directs the system to assign a file to the specified device 
or device type. The following descriptions refer to devices other than magnetic tape. 
For use of the ASSIGN statement with magnetic tape, refer to section 10. 

The control statement format is: 

ASSlGN(nn, lfn, {^J ) 

nn Device or device type to which the specified file is to be 

assigned; nn may be either the EST ordinal! of a peripheral 
device or the device type as defined as follows: 

Type Equipment 

CP 415 Card Punch 

CR 405 Card Reader 

DE Extended Core Storage 

DI 844-21 Disk Storage Subsystem 

DJ 844-41/44 Disk Storage Subsystem 

DP Distributive Data Path to ECS 

LP 512 or 580 Line Printer 

LQ 512 Line Printer 

LR 580-12 Line Printer 

LS 580-16 Line Printer 

LT 580-20 Line Printer 

MD 841 Multiple Disk Drive 

MS Mass Storage Device 

NE Null Equipment 

TT Time- Sharing Multiplexer! t 

lfn Name of the file to be assigned to the specified equipment 

CK Specifies that lfn is to be used as a checkpoint file. Each time 

a checkpoint dump is taken, the new information is written at the 
previous EOI of lfn. 

CB Specifies that lfn is to be used as a checkpoint file. Each time a 

checkpoint dump is taken, the new information is written at the 
BOI of lfn. 

Before performing the assignment, the system issues a RETURN on lfn. Any job can 
assign a file to MS, and any time-sharing origin job can assign a file to TT. However, 
to assign any other devices, the job must be of system origin or the user must be 
validated for system origin privileges.! 1 1 

If the user attempts to perform an assignment for which he is not validated, the job is 
aborted and the following message is issued to the user's dayfile. 

ILLEGAL USER ACCESS. 



| Contact installation personnel for a list of EST ordinals. 
| f This device type applies only to time- sharing origin jobs. 
! ! ! Refer to LIMITS control statement, section 6. 
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In addition, to assign a file to any nonmass storage device except device type TT, the 
user must be validated to use nonallocatable devices. If the user does not have this 
validation or the device is not available, the system aborts the job. 

The user should not normally assign any nonallocatable devices to his job. While it is 
possible to assign a central site card reader, line printer, or card punch directly on- 
line to the user's job, only a subset of the capabilities of local batch input/output are 
available through this method of access. Also, there is no need to assign nonallocatable 
devices to local files named OUTPUT, PUNCH, P8, or PUNCHB and any other local 
file disposed to an output queue because these files are always processed upon job 
completion. 

Example 1: 

ASSIGN(MS, OUTPUT) 

This statement assigns file OUTPUT to mass storage. With this assignment, a time -sharing 
user causes output normally printed at his terminal to be written on a mass storage 
file instead. Here, output means information generated by a program during execution. 
Informative and error messages are still printed at the terminal. Once this assign- 
ment is made, output is written on the mass storage file OUTPUT until the file is 
returned or reassigned. 

Example 2: 

ASSIGN(TT,XYZ) 

This statement assigns file XYZ to the user's time-sharing terminal. The assignment 
causes output that would normally be written on XYZ to be printed at the terminal in- 
stead. 

Example 3: 

ASSIGN(MD, ABC) 

This statement assigns file ABC to an 841 Multiple Disk Drive if one is available. 

The ASSIGN statement can also be used to create or access existing 7- or 9-track unlabeled 
tapes. For a description of the statement as it applies to magnetic tape assignment, refer 
to Tape Management, section 10. 

BKSP STATEMENT 

The BKSP control statement directs the system to bypass a specified number of logical 
records in the reverse direction. 

The control statement format is: 

BKSPdfn, n, m) 

lfn Name of the file to be backspaced 

n Number of logical records (decimal) to backspace; if this 

parameter is omitted, the system assumes n=l. 

m File mode; C for coded, B for binary. If omitted, the system 

assumes the file is in binary mode. 

The BKSP request can be issued at any point in a logical record. If, for example, 
FILE1 were positioned within the third record, a 

BSKP(FILEl) 
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request would reposition FILE1 to the beginning of the third record. The system does 
not backspace past the beginning., of information (BOI). However, EOF indicators are 
considered separate records and are included in the record count. An unrecognizable 
record count causes the message 

ERROR IN FILE ARGUMENTS. 

to be issued to the user's dayfile. 

I The BKSP statement has no effect on a primary file since that file is rewound before every 
operation. 

CATALOG STATEMENT 

The CATALOG control statement requests a listing of information about each record in a 
specified file. 

The control statement format is: 

CATALOG(lfn, p r p g , . . . , p n ) 

Ifn Name of the file to be cataloged 

p. May be one of the following. 

N=0 Catalog until an empty file is encountered 

N=x Catalog x files; default is N=l 

N Catalog to end of information 

L=fname Specifies the name of the file to receive output; 

if this parameter is omitted, the system assumes 
L«OUTPUT 

U Select user library list (not given unless selected) 

D Suppress all comment fields; suppress all page 

headings after the initial page heading for each 
individual file 

R Rewind lfn before and after cataloging 

CS Suppress character set list for OPL (old program 

library) and OPLC (old program library common 
deck) type records. 

The listing for each file of a multifile set begins on a new page with a page heading 
for that file. If the D option has been specified, the page heading appears only once, 
at the beginning of the file. The information listed includes: 

Number of the record cataloged. 

Record name from the first word of the record or the second word of the prefix 
(77) table, if present 

Record type (list of valid record types follow this list) 

Length (less 77 table length) in words printed as an octal number 

A checksum (not including the 77 table) 

Dates and comments in 77 table, if present 

Character set mode for OPL/ OPLC type records (unless suppressed by CS option) 
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Type may be one of the following. 



ABS 

CAP 

OPL 

OPLC 

OPLD 

OVL 

PP 

PPU 

REL 

TEXT 

ULIB 



Multiple entry point overlay 

Capsule loader record (supported by CDC CYBER Loader 1.3) | 
Modify old program library deck 
Modify old program library common deck 
Modify old program library directory 
Central processor overlay 
6000 series peripheral processor program 
7600 peripheral processor program 
Relocatable central processor program 
Unrecognizable as a program 
User library program 



Entry points are listed for REL and ABS format records. The entire record is listed 
for TEXT format records if the name of the record begins with CMRDECK, CMRDC, 
IPRDECK, IPRDC, LIBDECK, or LIBDC. The first line is listed for TEXT format 
records if the name of the record begins with OVERLAY. Correction identifiers and 
their YANK status (refer to the Modify Reference Manual) are listed for OPL and 
OPLC records. 

A ULIB format record suppresses listing of records in the library unless the U option is 
specified on the control statement. Zero-length records cause the length since the last zero- 
length record to be listed. EOFs cause the length since the last EOF to be listed. 

Figure 1-7-1 illustrates a portion of the catalog of SYSTEM. 



REC 
479 

480 



481 
482 



483 



484 



485 



CATALOG OF SYSTfcM 
NAME 



HELP 

HELP 

RFL = 
GTR 

GTR 

COPYRF 

MFL = 
LI3E0IT 
LISTLB 

LISTL8 

RFL = 

ARG = 
LIST80 

LIST80 

RFL = 
LU72 

LJ72 

RFL = 
MS'DRT 



TYP! 
ABS 

AiiS 



OVL 00»G0 
A6S 



A:5S 



ABS 



OVL JO, 00 



FILE 
LENGTH 

2374 
1614 



4402 
1156 



134 



3251 



1 
CKSUM DATE 

0652 75/04/19 



COMMENTS 
71/03/02. 73/12/17. 



6644 75/04/19. 73/05/17. 75/04/19. 



4143 
7017 



75/04/19 
75/04/19 



70/06/06 
74/01/18, 



75/04/19. 
75/04/19. 



255 



5774 75/04/19. 01/23/70. 71/02/14. 



7765 75/04/19. 70/08/01 



1100 75/04/J.9. 71/03/01. 73/08/15. 



Figure 1-7-1. Sample Page of Catalog of SYSTEM 
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486 


PACK 
PACK 
RFL* 


ABb 


440 


487 


RESEQ 
REScQ 
RFL» 


ABS 


1625 


488 


RESTART 
RESTART 
DMP» 
RFL« 
SSJ* 


A8S 


1365 


489 


SORT 


UVL 00*00 


757 


490 


STAGE 
STAGE 
RFL« 


ABS 


1161 


491 


SUBMIT 
SUBMIT 
RFL» 


ABS 


1521 


492 


TCQMND 
ASCII 
CSET 
PARITY 
RFL» 


A3S 


105 


493 


TOUMP 
TOUMP 
RFL* 


ABS 


1160 


494 


VALNET 


QVL 00*00 


6115 


495 


VERIFY 
VERIFY 
RFL = 


ABS 


1513 


496 


VFYLIB 
VFYLI8 
MFL = 


ABS 


1407 


497 


OUT 


PP (110U) 


152 


498 


SMP 


PP (1100) 


156 


499 


(00) 


SUM = 


115115 


500 


KRONREF 


QVL 00*00 


1706 


501 


MODIFY 
MODIFY 
RFL* 


ABS 


7272 


502 


OPLcDIT 
QPLEDIT 
MFL = 


ABS 


3475 


503 


UPHOD 
UPrtQD 
MFL = 


ABS 


1746 


504 


COMPASS 


ovl .oo/co 


720 


505 


CQMP3S 


QVL Oi*CO 


7006 


506 


C0MP3SA 


QVL 01*01 


13677 


507 


UPDATE 
UPDATE 
RFLs 


a3S 


14025 



1710 75/04/19. 71/01/06. 74/04/24. 



1644 75/04/19. 71/02/28. 75/04/19. 



2347 75/05/20. 73/09/25. 75/04/20. 



1357 75/04/19. 71/03/01. 72/03/06. 
3535 75/04/19. 73/06/26. 74/07/30. 



3066 75/04/22. 75/04/20. 



2622 75/04/19. 74/03/28. 74/08/28. 



4467 75/04/19. 73/05/05. 74/11/23. 



1234 75/04/19. 72/06/14. 

4226 75/04/19. 73/05/05. 75/04/19. 



2505 75/04/19. 73/12/07. 75/04/19. 



1752 75/04/19. 75/03/20. 

5337 75/04/19. 71/07/27. 73/05/08. 

3334 75/04/19. 70/10/26. 74/07/30. 

5174 75/04/19. 74/12/19. 75/04/19. 



6314 75/04/19. 75/03/20. 



1366 75/04/19. 70/06/06. 75/04/19, 



2452 75/03/27. 

7037 75/03/27. 

6127 75/03/27. 

6065 75/03/27. 



Figure 1-7-1. Sample Page of Catalog of SYSTEM (Contd) 
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CLEAR STATEMENT 

The CLEAR control statement releases all the user's current working files. 

The control statement format is: 
CLEAR. 

If a primary file exists, only the file name is retained; information within the file is purged. 
The empty file remains available as the primary file. 

COMMON STATEMENT 

The COMMON control statement is used to either create or access a library type file. 

The control statement format is: 
COMMON (lfn t , lfn 2 , . . . , lfn n ) 

lfn Logical file name 

The user must be validated to access/create library files. The specified file must be a 
local mass storage file. If lfn is not local, a search is made for a library file by that name 
and an error message issued if the file is not found. If the operation completes success- 
fully, the file is attached to the user's job as a library type file. 

Before a local file can be made a library file, it must be locked. Refer to LOCK Statement 
in this section. 

CONVERT STATEMENT 

The CONVERT control statement converts records from one character set to another. 

The control statement format is: 

CONVERT^, p 2 ,..., p.) 

p. May be one of the following. 

P=lfrij Input on file lfn^j if omitted, file OLD is assumed 

N=lfn2 Output on file lfti2; if omitted, file NEW is assumed 

RS=n* Maximum record size in characters (decimal); 

1 <_n <.500. If omitted, 300 is the assumed maxi- 
mum record size. (Each character is 6 bits. ) 

64 Convert from 63- to 64-character set; if omitted, no 

conversion takes place. The TS option must be 
specified if 64 is not. 

TS=t Convert from old time -sharing 61 -character set to 

new time-sharing 63-character set; t may be one of 
the following terminal types. 

t Terminal Type 

TTY ASCII code terminal with standard 

print 

COR Correspondence code terminal 

with standard print 

CORAPL Correspondence code terminal 

with APL print 

MEMAPL Memorex 1240 (ASCII code) termi- 

nal with APL print 

BLKEDT Block transmission (ASCII code) 

terminal with full display screen 
editing capability and standard 
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If t is omitted, it is assumed to be TTY. If TS is 
omitted, no time -sharing conversion takes place. 
The 64 option must be specified if TS is not. 

R Rewind input and output files prior to processing. 

If omitted, no rewind takes place. 

RC=n2 Convert n2 decimal records. If n2 is omitted, con- 

vert until an EOF is encountered. If RC is omitted, 
one record is assumed. 

NM Used in conjunction with TS parameter and specifies 

that conversion is to normal mode; if omitted, con- 
version is to ASCII mode. Note the effect of conver- 
sion on the following characters. 

/\ (circumflex) If TS is specified, display code 70 
(circumflex character) is con- 
verted to 76. If NM is omitted, 
conversion is to 7402 (ASCII mode). 

: (colon) If TS and 64 are specified, display 

code 63 (colon character) is con- 
verted to 00. If NM is omitted, 
conversion is to 7404 (ASCII mode). 

The following table lists legal conversion using the appropriate CONVERT parameter. 

Type of Record Legal Conversion Parameters 

63-character set, nontime-sharing record 64 

Old time -sharing record . TS or 

64 and TS 

New NORMAL time -sharing record 64 

(equivalent to BATCH character set) 

New ASCII time -sharing record none 



COPY STATEMENT 

The COPY control statement causes the first file specified to be copied to the second file. 

The control statement format is: 

COPYUfn^fn^x, c) 

lfn- Name of the file to copy from; if this parameter is omitted, file 

INPUT is assumed. 

lfn„ Name of the file to copy to; if this parameter is omitted, file 

OUTPUT is assumed. 

x If a third parameter (1 to 7 alphanumeric characters) is present, 

both files are rewound before the copy begins and rewound, veri- 
fied, and rewound again after the copy is complete. 

c If a fourth parameter (1 to 7 alphanumeric characters) is present, 

the copy to or from an SI, S, or L format tape is performed in 
coded rather than binary mode. 
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The copy begins at the current position of both files, unless the x parameter is speci- 
fied, and continues until an empty file (a double EOF) or EOI is encountered in lfnj_. 
If the copy is terminated by a double EOF, the second EOF is detected but is not trans- 
ferred to lfno. That is, if the files are not rewound after the copy (x parameter not 
specified), file lfn^ is positioned after the second EOF and lfn 2 after the first EOF. 

When a COPY control statement operates with B or E format magnetic tapes, a specific 
frame count (FC) is required to ensure logical coincidence between the original and the 
copy (refer to ASSIGN and LABEL Statements, section 10). For disk-to-tape and tape-to- 
disk copies, FC must equal 640, and for tape-to-tape copies, the FC counts for both 
tapes must be equal. 

The COPY statement may produce unpredictable results when copying S, L, and F 
format tapes. The user should check these formats in section 10 before using them 
with this control statement. 

COPYBF STATEMENT 

The COPYBF control statement causes a specified number of binary files to be copied from 
one file to another. 

The control statement format is: 
COPYBFdfnp lfn 2 , n, c) 

lfn-i Name of the file to copy from; if this parameter is omitted, file 

INPUT is assumed. 

lfn^ Name of the file to copy to; if this parameter is omitted, file 

OUTPUT is assumed. 

n Number of files (decimal) on lfn., to copy; if this parameter is 

omitted, n=l is assumed. 

c If a fourth parameter (1 to 7 alphanumeric characters) is present, 

the copy to or from an SI, S, or L format tape is performed in 
coded rather than binary mode. 

The copy begins at the current position of lfn-^. If lfn-plfn^, n files are skipped but no 
data transfer occurs. If the EOI is encountered before the file count is satisfied, an 
EOF is written on lfr^, and the operation terminates. 

When a COPYBF control statement operates with B or E format magnetic tapes, a 
specific frame count (FC) is required to ensure logical coincidence between the original 
and the copy (refer to ASSIGN and LABEL Statements, section 10). For disk-to-tape 
and tape-to-disk copies, FC must equal 640, and for tape-to-tape copies, the FC counts 
for both tapes must be equal. , 

The COPYBF statement may produce unpredictable results when copying S, L, and F 
format tapes. The user should check these formats in section 10 before using them with 
this oontrol statement. 
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COPYBR STATEMENT 

The COPYBR control statement causes a specified number of binary records to be copied 
from one file to another. 

The control statement format is: 

COPYBR(lfn r lfn 2 , n, c) 

lfn 1 Name of the file to copy from; if this parameter is omitted, 

file INPUT is assumed. 

lfn 2 Name of the file to copy to; if this parameter is omitted, 

file OUTPUT is assumed. 

n Number of records (decimal) to copy; if this parameter is 

omitted, n=l is assumed. 

c If a fourth parameter (1 to 7 alphanumeric characters) is 

present, the copy to or from an SI, S, or L format tape 
is performed in coded rather than binary mode. 

The copy begins at the current position of lfn^. EOF indicators are considered separate 
records and are included in the record count. If lfn^=lfn2» n records are skipped but 
no data transfer occurs. If the EOI is encountered before the record count is satisfied, 
an EOF is written on lfn2, and the operation terminates. 

The COPYBR statement may produce unpredictable results when copying S, L, and F 
format tapes. The user should check these formats in section 10 before using them 
with this control statement. 

COPYCF STATEMENT 

The COPYCF control statement directs the system to copy a specified number of files from 
one file to another. 

The control statement format is: 

COPYCF(lfni, lfn2, n, fchar.lchar) 

lfni Name of the file to copy from; if this parameter is omitted, 

file INPUT is assumed. 

Ifn2 Name of the file to copy to; if this parameter is omitted, 

file OUTPUT is assumed. 

n Number of files (decimal) to copy; if this parameter is 

omitted, n=l is assumed. 

fchar First 6 -bit character position of each line to 

copy; if this parameter is omitted, fchar=l is 
assumed. 

lchar Last 6-bit character position of each line to copy; 

if this parameter is omitted, lchar=136 is assumed. 

The copy begins at the current position of lfnj. If lfn 1 =lfn 2 , n files are skipped but no 
data transfer occurs. If the EOI is encountered before the file count is satisfied, an 
EOF is written on lfrio, and the operation terminates. COPYCF reformats the file into 
line images if it is blocked in greater than Lchar blocks. 
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If lchar is less than fchar, lchar is greater than 150, or either fchar or lchar is un- 
recognizable, the following error message is issued to the user's dayfile. 

ILLEGAL CHARACTER NUMBER. 

If COPYCF is attempted on a line longer than 150 (6-bit) characters, the following 
message is issued: 

NO LINE TERMINATOR. 

If n is illegal or zero, the following message is issued. 

ILLEGAL COUNT. 

The COPYCF statement may produce unpredictable results when copying S, L, and F 
format tapes. The user should check these formats in section 10 before using them 
with this control statement. 

COPYCR STATEMENT 

The COPYCR control statement directs the system to copy a specified number of records 
from one file to another. 

The control statement format is: 

COPYCRUfni, lfn 2 , n, fchar, lchar) 

lfni Name of the file to copy from; if this parameter is omitted, 

file INPUT is assumed. 

Ifri2 Name of the file to copy to; if this parameter is omitted, 

file OUTPUT is assumed. 

n Number of records (decimal) to copy; if this parameter is 

omitted, n=l is assumed. 

fchar First 6-bit character position of each line to 

copy; if this parameter is omitted, fchar=l is 
assumed. 

lchar Last 6-bit character position of each line to copy; 

if this- parameter is omitted, lchar=136 is 
assumed. 

The copy begins at the current position of lfn... If lfn^lfng, n records are skipped but 
no data transfer occurs. EOF indicators are considered separate records and are in- 
cluded in the record count. If the EOI is encountered before the record count is satis- 
fied, an EOF is written on lfn^, and the operation terminates. COPYCR is processed 
in exactly the same manner as the COPYCF control statement except that n specifies the 
number of records rather than the number of files. 

If COPYCR is attempted on a line longer than 150 (6-bit) characters, the following 
message is issued. 

NO LINE TERMINATOR. 

The COPYCR statement may produce unpredictable results when copying S, L, and F 
format tapes. The user should check these formats in section 10 before using them 
with this control statement. 
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COPYEI STATEMENT 

The COPYEI control statement directs the system to copy one file to another. 
The control statement format is: 

COPYEI(lfn r lfn 2 , x, c) 

lfn 1 Name of the file to copy from; if this parameter is omitted, 

file INPUT is assumed. 

lfn ? Name of the file to copy to; if this parameter is omitted, file 

OUTPUT is assumed. 

x If a third parameter (1 to 7 alphanumeric characters) is 

present, both files are rewound before the copy, and rewound, 
verified, and rewound again after the copy is complete. 

c If a fourth parameter (1 to 7 alphanumeric characters) is 

present, the copy to or from an SI, S, or L format tape is 
performed in coded rather than binary mode. 

The copy begins at the current position of lftu and continues until the EOI is encountered. 
The EOI is not defined for certain tape formats (refer to Data Formats, section 10). 

When a COPYEI control statement operates with B or E format magnetic tapes, a 
specific frame count (FC) is required to ensure logical coincidence between the original 
and the copy (refer to ASSIGN and LABEL Statements, section 10). For disk-to-tape 
and tape-to-disk copies, FC must equal 640, and for tape-to-tape copies, the FC counts 
for both tapes must be equal. 

The COPYEI statement may produce unpredictable results when copying S, L, and F 
format tapes. The user should check these formats in section 10 before using them 
with this control statement. 

COPYSBF STATEMENT 

The COPYSBF control statement enables the user to copy a file where the first character of 
each line is not a printer control character and is to be printed. 

The control statement format is: 
COPYSBFdfn^ lfn 2 , n) 

lfn^ Name of the file to copy from; if this parameter is omitted, 

file INPUT is assumed. 

lfn 2 Name of the file to copy to; if this parameter is omitted, file 

OUTPUT is assumed. 

n Number of files (decimal) to copy; if this parameter is omitted, 

n=l is assumed. 

The COPYSBF routine copies n files beginning at the current position of lfn- to file lfn , 
shifting each line image one character to the right and adding a leading space. Each 
line image may contain up to 150 (6 -bit) characters. Any characters beyond 150 will 
be lost. A page eject character is inserted at the beginning of each logical record 
(refer to section 9 for a list of carriage control characters). If lfn.,=lfn 2 , n files are 
skipped but no data transfer occurs. If the EOI is encountered before the file count is 
satisfied, an EOF is written to lfn ? , and the operation terminates. 
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If COPYSBF is attempted on a line longer than 150 (6-bit) characters, the following 
message is issued. 

NO LINE TERMINATOR. 

The COPYSBF statement may produce upredictable results when copying S, L, and F 
format tapes. The user should check these formats in section 10 before using them 
with this control statement. 

COPYX STATEMENT 

The COPYX control statement enables the user to specify certain conditions when copying 
logical records. 

The control statement format is: 

COPYXdfnj, lfn 2 , x, b, c) 

lfni Name of the file to copy from; if this parameter is omitted, 

file INPUT is assumed. 

Ifn2 Name of the file to copy to; if this parameter is omitted, 

file OUTPUT is assumed. 

x Copy specifications; if omitted, one record is copied. The 

value for x may be one of the following: 

x Meaning 

n Number of records (decimal) to copy 

00 Copy all records up to and including first 

zero-length record (double EOF or EOI) 

name Copy all records up to and including record 

of specified name (record name is first 
seven characters of record) 

type /name Copy all records up to and including record 
of specified type and name (refer to CATA- 
LOG control statement for list of valid 
record types) 

b Backspace control; if omitted, is assumed. 

b Meaning 

No backspace 

1 Backspace file lfn., one record after copy 
completes 

2 Backspace file lfn2 one record after copy 
completes 

3 Backspace files lfnj and lfn 2 one record 
after copy completes 

c If a fifth parameter (1 to 7 alphanumeric characters) is 

present, the copy to or from an SI, S, or L format tape 
is performed in coded rather than binary mode. 

The COPYX routine copies logical records from file lfn^ to file lfri2 at the current position 
of lfn^ until the condition specified by x is met. It then backspaces the files according to 
the value specified by the b parameter. If lfni=lfn2, the file is repositioned according to 
the x parameter; no data is transferred. 
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The COPYX statement may produce unpredictable results when copying S, L, and F format 
tapes. The user should check these formats in section 10 before using them with this control 
statement. 

DISPOSE STATEMENT! 

The DISPOSE control statement is used to release specified files to the proper output 
queues. 

The control statement format is: 

DISPOSE(lfn 1 =qi, Ifti2=q2» ...» lfn n =q n /ot=usernum) 
lfn£ Name of the file to be disposed 

q*. Queue type: 

PR Print 

PH Punch coded 026 

P9 Punch coded 029 

PB Punch binary 

P8 Punch 80 -column binary 

ot Origin type to which files are to be disposed: 

BC Local batch 

EI Remote batch (Export/import) 

usernum Number of the remote batch (that is, ot is EI) user to which 

the files are to be disposed (ignored if ot is BC). This 
parameter is valid only if the user is allowed deferred batch 
jobs. Also, usernum must match the number of the user 
performing the DISPOSE on all character positions except 
those containing an *. 

The file type for file lftij_ is changed to q t in the FNT/FST entry for lfn^ The system 
then processes the file according to queue type. The user can dispose coded punch 
files to either 026 or 029 regardless of the job's initial keypunch mode. If the system 
cannot recognize q^, the following message is issued. 

ILLEGAL DISPOSE CODE. 

If the ot and usernum parameters are not specified, a remote batch job disposes the 
files to the remote terminal from which it was submitted, and all other origin types 
dispose the files to the central site output device. If ot is BC, the usernum parameter 
is ignored and the files are disposed to the central site device. 



t The user should employ the ROUTE control statement for this operation. 
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DOCMENT STATEMENT 

The DOCMENT control statement enables the user to extract either the external or internal 
documentation from a file containing COMPASS source code. 

The control statement format is: 

DOCMENT(p p p 2 , . . . , p n ) 

Pi The parameters can be in any order and must be in one 

of the following forms. 

Omitted The first default value is assumed. 

a The alternate default value is assumed. 

a=x x is substituted for the assumed value. 

Any numeric parameter can be specified with a postradix character of either B or D. 
The values that p^ can assume are: 

I=lfni Name of the file that contains the page footing information; 

this must be a single statement in the following format. 

Column(s) Contents 



1 Blank 

2-45 Document title 

46-55 Publication number 

56-60 Revision level 

61-70 Revision date 

S=lfn2 Name of the file containing the source statement images from 

which to extract the documentation. This file is rewound by 
default unless the NR parameter is specified. 

L=lfn 3 Name of the file on which the output is to be written 

N=nn Number of copies to be produced 

T=type Documentation type: 

INT Internal documentation (detailed description 

of the internal features of the software) 

EXT External documentation (detailed description 

of the external features of the software) 

C=cc Key character for documentation 

P=pp Number of print lines per page 

NR Disable rewind on the S (source) file 

NT Negate table generator 

TC List table of contents 



I 
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The following are the default values for the parameters described. 
Parameter 



First 
Default 







Alternate 
Default 



INPUT 



s 


COMPILE 


SOURCE 


L 


OUTPUT 


OUTPUT 


N 


1 


1 


T 


EXT 


INT 


C 


* 


03 


P 


60 


80 


NR 


REWIND 


NO REWIND 


NT 


ON 


OFF 


TC 


OFF 


ON 



Comment 



Page footing information; if I 
is 0, no footing information 
is printed. 

Source statement images 

List file 

Number of copies (decimal) 

Documentation type 

Check character (two octal 
digits) 

Number of print lines per page 

Source file rewind status 

Table generator status 

Table of contents status 



Refer to appendix C, volume 2 for a detailed explanation of the documentation standards 
followed. It also contains examples of external and internal documentation for program 
COPYB. 

EVICT STATEMENT 

The EVICT control statement releases file space for a specified file(s) but does not release 
file attachment to the job. 

The control statement format is: 

EVICT(lfn r lfn 2 , . . . , lfn R ) 



lfn. 



Name(s) of the file(s) to be evicted 



The operation that EVICT performs depends on the file type. For permanent files, all 
file space except the first track is released, job attachment remains, and an EOI is 
written on the first sector of the first track. For all other file types, file space is 
released and job attachment remains. Also, all files for which write lockout is set 
are returned to the system. An EVICT of a tape file performs the same function as 
a RETURN except that EVICT cannot be used to decrease the number of tape units 
scheduled via the RESOURC statement. 
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GTR STATEMENT 

The GTR control statement provides directives for specifying certain records to be copied 
from one file to another. 

The control statement format is: 

GTRdfn. , lfn , D, NR, S)selection directives 

The parameters must be entered in the order shown; they are defined as follows: 

lfn. File which is searched for the selected records; if this pa- 



rameter is omitted, file OLD is assumed. 



lfn 9 File on which the selected records are written; if this pa- 

rameter is omitted, file LGO is assumed. 

D If specified, a directory record (OPLD type) is written at the end 

of lft^. In this case, lfr^ must be a mass storage file. 

This parameter has special meaning for ULIB type records, as 
follows: 

If D is omitted, the first record of the user library, that 
is, the directory record (UPLD), is not copied to lfn2J 
the last record (OPLD type) is copied but is not altered. 

If D is specified, the first record of the user library (UPLD) 
is copied to lfr^, but is not altered, and an additional record, 
a new directory for the file (OPLD type), is added to lfn 2 » 

NR If specified, neither file is rewound after the operation. If not 

specified, both files are rewound after the operation. 

S lfn-, is processed as a sequential file; no attempt is made to read 

a directory. 

selection The user can specify the record types and names that he wants 

directives retrieved; these can be: 

type/name Retrieves record of specified type and name 

(refer to CATALOG control statement for a 
list of valid record types). The record name 
is the first seven characters of the record. 

name Retrieves the record specified; the type is 

either TEXT or the type specified previously. 
If name=*, all records of the specified type 
are retrieved. 

Inserts a zero-length record on file lfru. 

type/name.. - Retrieves records name, through name„ of 
name. type specified. 

GTR searches file lfn^ for the records specified by the selection directives. The selected 
records are then copied to file lfn2. If lfn 2 is a tape file, the selected records are copied 
from the current position; if lfn2 resides on mass storage, the copy starts at the current 
EOI of the file. This is because lfn2 is treated as a random file. Note that blanks are not 
legal between the terminator and the selection directives. 
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Examples of the use of this control statements are: 

• GTR(SYSTEM,BIN,D)PP/* 

All records of type PP are retrieved from file SYSTEM and copied to file BIN. 
A directory is built and placed as the last record on file BIN. 

• GTR(OPL, NEW, , NR)OPLC/COMCARG, 0, COMCCIO 

Record COMCARG (type OPLC) is retrieved from file OPL and written on 
file NEW beginning at the current EOI. Then a zero-length record is written 
on file NEW. Finally, record COMCCIO (also type OPLC) is retrieved from 
file OPL and written on file NEW at its current position. File OPL is not 
rewound either before or after the operation. 

• GTR(SYSTEM, SYSLIB, D)ULIB/ SYSLIB 

The record named SYSLIB (type ULIB) is retrieved from file SYSTEM and 
copied to file SYSLIB. The D parameter must be specified to copy the ULIB 
directory (UPLD) of a ULIB record set. If the D parameter were omitted, 
the UPLD record would be skipped. 

LIBEDIT STATEMENT 

The LIBEDIT control statement specifies directives for editing and replacing binary records 
on a file with records from one or more correction files. 

The control statement format is: 



LIBEDrHp^pgi 
Pi 



Pn> 



Any of the following parameters in any order: 

I=lfni Directives comprise the next record on file lfnj. 

1=0 No directive input. 

I omitted Directives are on file INPUT. 

P :r lfn2 File lfn2 contains the old program library. 

P=0 No old program library file. 

P omitted Old program library is on file OLD. 

N=lfn3 New program library will be written on file lfivj. 

N=0 Illegal; no error message is issued, if used. 

N omitted New program library will be written on file NEW, 



L=l 



L=0 

L omitted 



NOTE 



The new program library is evicted 
prior to processing (refer to EVICT 
Statement in this section). 

Short correction listing (includes only directives, 

modifications, and errors) on the file specified 

by the LO parameter. 

No output is listed. 

Full correction listing is written on the file 

specified by the LO parameter. 



LO=lfn4 List output on file If 114. 

LO omitted List output on file OUTPUT. 



B-lfn 5 

B=0 

B omitted 



Use file lfn5 for the replacement file. 
Do not use a default replacement file. 
Use file LGO as the default replacement file. 
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C Copy the new program library file over the old 

program library file after processing. 

C omitted Do not copy the new program library file over 
the old program library file after processing. 

R Do not rewind program library files after 

processing. 
R omitted Rewind old and new program library files after 

LIBEDIT and VFYLIB processing. 

V Call VFYLIB after LIBEDIT processing. 

V omitted Do not call VFYLIB to verify program libraries 

after LIBEDIT processing. 

D Ignore errors and continue. 

D omitted Do not ignore errors; abort job. 

For a description of the LIBEDIT directives and examples of their use, refer to appendix C. | 

LIBGEN STATEMENT 

The LIBGEN control statement allows the user to generate a user library file. 

The control statement format is: 

LIBGEN(p 1 , p 2 , . . . , p n ) 

P^ Any of the following in any order: 

F=lfn^ Name of source file containing records to be 

placed on user library file lft^. 

F System assumes source file LGO. 

F omitted System assumes source file LGO. 

P=lfn„ Name of the file on which the user library is 

to be written. 

P System assumes user library to be written 

on ULIB. 

P omitted System assumes user library to be written 
on ULIB. 

N=lfng Name of the user library being generated; this 

name becomes the name of the ULIB and OPLD 
records. 

N System assumes Ifn3=lfn2« 

N omitted System assumes lftig^fng. 

NX=n If n is nonzero, no cross-references are given. 

That is, decks are not cross -linked in the ULIB 
directory. This can be used to avoid duplicate 
entry points on loads. 

NX omitted The system assumes n=0. 



LIBGEN processes the source file specified and generates a user library file on the file 
specified with the P parameter. The user library is given the name specified with the N 
parameter. If the F and P options specify the same file, the message 

FILE NAME CONFLICT. 

is issued. 

The F and P parameters may appear more than once. In such a case, the last occurrence 
is used. 



60435400 C 



1-7-19 



LIBGEN rewinds and scans the source file and builds a directory of all entry points, program 
names, and external references for records in the file. When an EOF mark appears, 
LIBGEN terminates the directory and rewinds lfn^. LIBGEN then copies lfn^ to lfno, adding 
the library and directory records. The directory is written as the first record of the new 
file. It is indicated as a user library type record by a 76 identification table. The identifica- 
tion table also contains the name of the library. 

The directory contains all external references within the library and the linkage to routines 
that reside in the library. This indicates which routines must be loaded when routines from 
I this library are loaded. This means that all externals for routines in a user library are 
automatically satisfied from that library first. 

The entire file follows the directory record on the new file. The file index is the last record 
on the file. This record contains random addresses for each record in the file. The index 
| record has a table identifier of 7000 fi . LIBGEN processes REL type records, bypassing all 
other record types. 

For example, file RELB contains routines that are used at execution time for several appli- 
cation programs. It is desirable to load these routines as needed when executing the applica- 
| tion programs. To generate the user library, the following control statement 

LIBGEN(F=RELB, P=MYLIB, N=APPLIB) 

is entered. This creates user library APPLIB on file MYLIB. If FORTRAN application 
programs are compiled using the control statement. 

FTN. 

the user library can be used by loading the program in the following manner. 

LDSET(LIB=MYLIB/RUNLIB) 

LOAD(LGO) 

EXECUTE. 

This causes the program to be loaded and executed with externals satisfied first from user 
library MYLIB, then from user library RUNLIB, and finally from the system default library 
SYSLIB. 

I For examples of the use of LIBGEN, refer to appendix C. 

UST80 STATEMENT 

The LIST80 routine reads a file containing COMPASS source code and compresses it to 
80 columns, which fits on 8-1 /"2 by 11-inch printer paper. 

The control statement format is: 

LISTSOdfnplfn^NR) 

lfni File to copy from; if this parameter is omitted, file LIST 

is assumed. 

lfn 2 File to copy to; if this parameter is omitted, file OUTPUT 

is assumed. 



NR 



If this parameter is specified, lfnj is not rewound. 
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LOCK STATEMENT 

The LOCK control statement enables the user to prevent writing on a file. 
The control statement format is: 
LOCKUf n x , If n 2 , . . . , If n n ) 

lfn. Logical file name of a local file 

With the LOCK statement, the user can set the write interlock bit in the-FNT/FST entry for 
a local file. Subsequently, the system allows only read operations on the file. The 
file specified must be a local file; if it is not, the following message is issued. 

ILLEGAL FILE TYPE. 

The LOCK statement may also be used in conjunction with the COMMON statement to lock 
local files before making them library files for multiple user access. Refer to Library 
Files in section 2 and the COMMON control statement in this section. 

L072 STATEMENT 

The L072 control statement allows the user to specify the reformatting of his files. 
The control statement format is: 
L072(p 1 ,p 2 , . . . ,p n ) 

Pj Any of the following parameters in any order: 

I Reformat parameters are on file INPUT. 

I=lfnj Reformat parameters are on file lfn... 

1=0 There is no input file of reformat parameters. 

If the I parameter is omitted, 1=0 is assumed. 

S Data to be reformatted is on file SCR. 

S=lfn 2 Data to be reformatted is on file lfn 2 . If the 

S parameter is omitted, SCR is assumed. 

L Reformatted data is listed on file OUTPUT. 

L=lfn 3 Reformatted data is listed on file lfn 3 . If the 

L parameter is omitted, OUTPUT is assumed. 

T File to be reformatted is of type B. 

T=x File to be reformatted is of type x, where x is: 

M Modify source data 

C COMPASS source data 

B Other source data 

If the T parameter is omitted, B is assumed. 

H Number of characters per output line is 72. 

H=xxx Number of characters per output line is xxx 

(maximum allowed is 150 characters). If the 
H parameter is omitted, 72 is assumed. 



NOTE 



H must be greater than or equal to the 
number of characters being moved (Nx) 
plus the starting column number of the 
destination field (Ox). 
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LP 
NR 

Nx=y 



Output is formatted for the line printer. 

Output file is not rewound. 

Specifies the number of characters to be moved 
(up to 6 fields): 

x(l to 6) Number of the field being moved 

y Number of characters being moved 



NOTE 



Ix=y 



Ox=y 



IT 



N1+N2+N3+N4+N5+N6 must be less than or 
equal to the number of columns specified 
in the H parameter. 

Specifies the field the data originates from: 
x(l to 6) Number of the field being moved 
y Starting column of originating field 

Specifies the destination field the data is going to: 
x(l to 6) Number of the field to receive data 

y Starting column of destination field 

Suppresses query to terminal asking if user wishes 
to change any of the input parameters before proc- 
essing begins. If omitted, query is issued. This 
parameter is effective only from time- sharing 
origin jobs. 

The following table shows the default values assumed for the N, O, and I parameters 
for the various source types. 

Type 
B 
C 

M 

The remaining parameters of these types are defaulted to 0. 

L072 reformats files (output files in general). The user can rearrange each line (all 
lines must be formatted the same) in the format he chooses. All default values com- 
press output to 72 columns, which is appropriate for terminal output or 8-1/2 by 11-inch 
printer paper. If a 1 is encountered in column 1 (the page eject printer control char- 
acter), the next two lines of source data are processed as a two-line header. This 
header is compressed to 72 columns for all source types. If no page eject control 
characters are encountered, no headers are processed. 

The following values apply to the first line of header and cannot be changed. 

Nl=42, 11=8, Ol=0 (if LP not specified; otherwise, 01 = 1) 
N2=20, 12=90^ 02=42 
N3=5, 13 = 115, 03 = 62 
N4=5, 14 = 121, 04=67 

The subheader lines for COMPASS and Modify listings are processed uniquely. 



Nl 


11 


Ol 


N2 


12 


02 


N3 


13 


03 


72 


1 


1 




















7 


9 


1 


50 


41 


8 


15 


112 


58 


2 


6 


1 


48 


10 


3 


22 


82 


51 



I 1-7-22 



60435400 C 



For B listings, the following values apply to the reformatting. 

Nl=43, 11=8, Ol=0 (if LP not specified; otherwise, 01 = 1) 
N2=29, 12 = 70, 02=43 

All parameters are passed to L072 by the control statement. If an input file is specified, 
L072 reads it for additional input parameters. If the job originates from a time-sharing 
terminal, and the IT parameter is not specified, the user is asked if he wishes to change 
any of the input parameters. If he enters YES, the system prints the current parameter 
values and allows him to change them individually. Pressing the carriage return key for any 
parameter leaves the parameter at its former value. In the following examples, the same 
input parameters are entered Ln three possible ways. 

Control Statement : 



LO72(I=0, S=SOURCE, T=B, LOUT, N4 = 1,I4=2, 04 = 75, H=90) 

Time -Sharing Terminal: (User entries are in lowercase. The symbol @ 
indicates carriage return. ) 

/lo72 

DO YOU WANT TO CHANGE ANY CONTROL ARGUMENT VALUES- 
ENTER: YES OR NO 
? yes @ 

ARGUMENT VALUE 

INPUT FILE NAME: ? @ 

SOURCE FILE NAME: SCR ? source © 
OUTPUT FILE NAME: OUTPUT ? out @ 
SOURCE FILE TYPE: BATCH ? b @ 
OUTPUT LINE LENGTH: 72 CHARS.? 90 @ 
NO. OF MOVED FROM MOVED TO 
CHARS . COLUMN COLUMN 
(X) (NX) (IX) (OX) 

1 1 











ENTER CHANGES IN THE FOLLOWING FORMAT: 
NX=AA*CR* 
IX=BB*CR* 
0X=CC*CR* 
ETC. 

TO CONTINUE, ENTER *CR* ONLY. ? n4=l @ 
? i4=2 ® 
? o4=75 @ 
?® 
L072 COMPLETE. 

Input File: (Each line in the input file must end with a terminator. ) 

S=SOURCE, L=OUT, T=B. 
N4 = l, 14=2, 04=75 
H=90. 
-EOR- 
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1. 


72 


2. 





3. 





4. 





5. 





6. 






NEW STATEMENT 

The NEW control statement creates a primary file. 

The control statement format is: 

NEW(lfn/ND) 

lfn Name of file to be made primary file 

ND If this parameter is specified, current working files are not 

released 

The NEW statement creates an empty file and makes it the user's new primary file. Any 
currently existing primary file is released. 

Note that -all current working files are released unless the ND parameter is specified. 

I Refer to the note in PRIMARY Statement in this section for use of primary file types. 

OUT STATEMENT 

The OUT control statement is used to release output files from the control point to the 
output queue. 

The control statement format is: 

OUT. 

The only files released are those having the names 

OUTPUT. 
PUNCH 
PUNCHB 
P8 

or any local files belonging to one of these types. An example would be any of the above 
files that had been renamed. 

This control statement is used if the user wishes to initiate printing or punching of the files 
before job termination. The PUNCH file is punched in either 026 or 029 mode depending 
on the origin of the job. If the job is a local batch job, the coded deck is punched in the 
initial keypunch mode of the job's control statement record. For all other job origin types, 
the coded file is punched in the system default keypunch mode. 
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PACK STATEMENT 

The PACK control statement allows the user to pack a specified file and copy it to another. 

The control statement format is: 

PACK(lfn lf lfn 2 ,x) 

lfnj Name of file to be packed 

lfn„ Name of file to receive packed data 

x If a third parameter (1 to 7 alphanumeric characters) is 

specified, lfni is not rewound before the pack occurs. 

The input file, lfnj_, may consist of any number of records and/or files. If no third 
parameter is supplied, lfnj is read from the BOI to the EOI, and all EOR and EOF 
marks are removed. It is written to file lfn 2 at the current position as one record. 
File lfrig is rewound after the pack; Ifn^ is not. If lfn 2 is not specified, file lfn.. is 
packed fo itself. 

The programmer should note that problems may arise when using PACK with direct 
access files. For example, if file A resides on a legal direct access file device and 
the following cards are submitted: 

PACK(A) 
DEFINE(A) 

PACK may copy file A to a device which does not support direct access files. In this 
event, the DEFINE statement would then cause the job to abort and the following message 
to be issued to the user's dayfile 

DIRECT ACCESS DEVICE ERROR, AT nnn. 
where nnn is the file environment table (FET) address, f 

The user can avoid this situation by defining file A as an empty direct access file, 
creating the file, and then packing it. 

DEFINE(A) 
create file A 
PACK(A) 

The following error messages may be issued to the user's dayfile in response to a PACK 
statement. 

Message Description 

PACK PARAMETER ERROR. The PACK control statement contains an error. 

ILLEGAL INPUT FILE. An attempt was made to pack a file that is 

assigned to a time-sharing terminal (for 
example, file INPUT for time- sharing origin 
jobs represents data typed at the terminal 
keyboard, and therefore, cannot be packed). 

ILLEGAL CIO REQUEST. An attempt was made to pack a nonmass 

storage file. 

WRITE ON READ-ONLY FILE fff, The direct access file was not attached in 

AT nnn. write mode (refer to ATTACH Statement, 

section 8). 



t Refer to Permanent File Manager, section 5, volume 2. 
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PRIMARY STATEMENT 

The PRIMARY control statement makes a local file the primary file. 

The control statement format is: 
PRIMARY(lfn) 

lfn Name of local file 

The file to be made primary must be a local mass storage file. Any currently existing 
primary file (other than the lfn specified) is released. If the specified file is already pri- 
mary, the operation is ignored. 



NOTE 



The primary file is rewound before every operation 
performed on that file. Therefore, the file manipu- 
lation statements BKSP, SKIPEI, SKIPF, SKIPFB, 
and SKIPR cannot be used to position within the file. 
The user should also remember that the primary 
file is rewound after the completion of any of the 
COPY statements. An attempt to add to the file 
using one of the COPY statements may result in 
writing over existing data at the BOI. 

RENAME STATEMENT 

The RENAME control statement allows the user to change the name of a local file. 

The control statement format is: 

RENAME (nlfn 1 =olfn 1 , nlfn =olfn„, . . . , nlfn =olfn ) 
l l & 2, n n 

nlfn^ New name of the local file 

olfn. Existing name of the local file 

The RENAME control statement is used to change the name of the file olfnj to nlfn. in the 
FNT/FST. This does not change the names of files in the permanent file system. Normally, 
the file type of nlfn is the same as the file type of olfn. 

If a file by the name nlfn. already exists, it is returned to the system. Under certain 
conditions, the system also changes the file type of olfnj to that of the file which was returned. 

• If olfn. is a local mass storage file and the returned file was a print, punch, 
or primary type file, olfni is renamed and its file type is changed to that 

of the returned file. 

• If olfn. is a local mass storage file and the returned file was not a print, 
punch, or primary type file, olfn^ is renamed but its file type is not changed. 

• If olfn. is not a local file and nlfn and olfn are not the same file types or if olfn: 
does not reside on mass storage, an 

ILLEGAL FILE TYPE, 
error message is issued. 
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For example, the user has only two files assigned to his job. File A is a local mass 
storage file and file B is a print type file. If the user issues the following request 

RENAME(X=A) 

file A is renamed file X and its file type (local) is not changed. However, if the user issues 
the request 

RENAME(B=A) 

file B is returned to the system; file A is renamed file B and changed to a print type file. 

REQUEST STATEMENT 

The REQUEST control statement enables the user to assign a file to a device by including 
in the comment field a description of an acceptable device. 

The control statement format is: 

REQUESTdfn, {^)) 

lfn Name of the file to be assigned to the specified equipment. 

CK Specifies that lfn is to be used as a checkpoint file. Each time 

a checkpoint dump is taken, the new information is written at the 
previous EOI of lfn. 

CB Specifies that lfn is to be used as a checkpoint file. Each time 

a checkpoint dump is taken, the new information is written at the 
BOI of lfn. 

The descriptive comment is displayed at the system console, directing the operator to 
make the requested assignment. 

If lfn already exists when the REQUEST is made, no new assignment is made and job 
processing continues with the next control statement. However, the user can reassign lfn 
by issuing a RETURN on the file before making the REQUEST. 

Any user, regardless of his validation, may use the REQUEST statement to assign a file 
to a mass storage device. However, to assign a file to a nonmass storage device, 
the user must be validated to use nonallocatable devices, t If the user does not have 
this validation and attempts to request a nonmass storage device, the system aborts 
his job. 



t Refer to LIMITS control statement, section 6, 
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If lfn is to be used for checkpoint dumps, either the CK or CB keyword is specified. 
These keywords are used in conjunction with the CKP and RESTART control statements; 
they allow the user to: 

• Save all checkpoint dumps by appending each dump to the checkpoint file: 

REQUESTQfn, CK) 

• Save the last checkpoint dump by writing each dump at the beginning of the 
checkpoint file: 

REQUEST<lfn, CB) 

• Save two consecutive checkpoint dumps by alternately writing on two 
checkpoint files: 

REQUESTOR, CB) 
REQUEST(lfn 2 ,CB) 

If the CK parameter is specified for alternate files or if more than two checkpoint files 
are specified, the job is aborted and the following message is issued to the user's day- 
file. 

CHECKPOINT FILE ERROR. 

The CK and CB parameters specify a checkpoint file that is local to the job. The user 
can make the checkpoint file permanent by placing a DEFINE statement! before the REQUEST. 

DEFINE(lfn) 

REQUESTdfn, CK) 

CKP. 

The user is not required to supply a REQUEST statement to define a checkpoint file. He 
can use an ASSIGN or LABEL statement or he can use default values. 

If no REQUEST statement specifying a checkpoint file has been detected when the first CKP 
statement is encountered, the system requests a device for the user, specifies a file name 
of CCCCCCC, and selects the CK option. For a subsequent restart job, however, the 
system assumes the user has made the checkpoint file available. 

The REQUEST statement can also be used to create or access existing 7- or 9-track un- 
labeled tapes. If a magnetic tape assignment is needed to satisfy a REQUEST, the MT or 
NT parameter should be specified. For a description of magnetic tape assignment with the 
REQUEST statement, refer to Tape Management, section 10. 



•f Any mass storage file used as a checkpoint file must have write permission. 
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RESEQ STATEMENT 

The RESEQ control statement is used to resequence source files which have leading sequence 
numbers or to add sequence numbers to an unsequenced file. | 

The control statement format is: 

RESEQ(lfn, t, xxx, yy) 

lfn Name of the file to be resequenced 

t Type of file: 

B BASIC source code 

T Text source information; a five-digit sequence 

number plus a blank is added at the beginning 
of each line; the file text, however, is not in- 
spected 

other Any number at the beginning of a line is Con- 

or sidered a sequence number and is resequenced 

omitted according to the xxx and yy parameters; numbers 

are added to lines where no leading sequence 
numbers are present. This option can be used 
with time -sharing FORTRAN statements. 

xxx New line number of the first statement; if this parameter is 

omitted, the system assumes xxx=100 

yy Increment to be added to xxx for each succeeding line number; 

if this parameter is omitted, the system assumes yy=10. 

Files which have leading sequence numbers include time-sharing FORTRAN and BASIC 
source files. If the file has no leading sequence numbers, five-digit numbers are 
attached to the beginning of each line. If the line number encountered or required ex- 
ceeds 99999, the following message is issued. 

LINE NUMBER LIMIT EXCEEDED. 

Some BASIC statements reference the sequence numbers which must also be changed; 
therefore, it is imperative that the user specify the proper file type (t). When errors 
occur while resequencing a BASIC program, the following message is issued for all 
lines containing errors. 

ERROR AT LINE xxx. 

The file being resequenced by the RESEQ statement must have previosuly been sorted. 
Results are unpredictable if this requirement is not met. 

RETURN STATEMENT 

The RETURN control statement releases the specified file from job attachment and/or 
releases its file space. 

The control statement format is: 

RETURN(lfn 1 ,lfn ,...,lfn ) 
1 a n 

lfru Name(s) of the file(s) to be returned 
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The operation performed depends on the file type. 

Type Operation 

Input The file name is changed to INPUT*. File space is not 

released; INPUT* remains attached to the job as a local 
file (refer to Input File Control in section 3 for further 
information). 

Print Job attachment and file space are released. 

Punch Job attachment and file space are released. 

Local Job attachment and file space are released. 

System Job attachment is released but file space remains. 

Library Job attachment is released but file space remains. 

Primary Job attachment and file space are released. 

Permanent Write interlock is cleared. Job attachment is released 

but file space remains. 

In addition, the RETURN statement can be used to decrease the number of tapes or packs 
scheduled for the job via the RESOURC control statement. However, the number of tapes 
or packs scheduled is decremented only if the number of tapes or packs scheduled have 
actually been assigned to the user's job. 



REWIND STATEMENT 

The REWIND control statement causes files to be rewound and positioned to the BOI 
(or beginning- of- reel for magnetic tape files). 

The control statement format is: 

REWIND(lfh 1 ,lfn ,...,lfn ) 
l <s n 

lfn. Name(s) of file(s) to be rewound 

If the previous operation on the magnetic tape file was a write, a REWIND statement 
causes the following operations to be. performed. 

1. If the tape is ANSI labeled, the system writes a tape mark, an EOF1 label, 
and three tape marks and then rewinds the tape. 

2. If the tape is unlabeled and the data format specified on the ASSIGN, LABEL, 
or REQUEST statement is X, S, L, E, B, or F, the system writes four tape 
marks and then rewinds the tape. 

3. If the tape is unlabeled and the data format is I or SI, the system writes 
a tape mark, an EOF1 label, and three tape marks and then rewinds the 
tape. 

Refer to Tape Management control statements in section 10 for further information about 
tape files and to appendix G for a description of EOF1 and EOV1 labels. 
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ROUTE STATEMENT 

The ROUTE control statement releases or prepares for release a designated file to the input 
or output queue. The parameters associated with the file may take effect when the statement 
is processed or may be deferred to a later job step or job termination. This statement also 
allows the user to rescind a prior deferred ROUTE statement, thereby making the named 
file type LOFT. 

The control statement format is: 

ROUTE (lfn, p p p 2 , ..., p n ) 

lfn Name of the file to route; depending on the options specified, 

the file may be created or it may preexist. 

The remaining parameters are order- independent, but at least one must appear. 

p- Description 

PC=xx Disposition code; assumes any one of the following 

2-character codes. 

IN Release file to input queue (Normal job input file for- 

mat is required. ) 

LP Print on any printer 

PR Same as LP 

P2 Print on 512 printer 

LQ Same as P2 

LR Print on 580-12 printer 

LS Print on 580-16 printer 

LT Print on 580-20 printer 

SB Punch system binary 

PB Same as SB 

P8 Punch 80-column binary 

PU Punch coded 

PH Same as PU 

SC Rescind prior routing and make file LOFT 

If the DC parameter is omitted, the default will depend on whether 
or not a special file name is specified for lfn. If lfn is not a 
special file name, the default is DC=SC. If lfn is a special file 
name, DC will assume one of the following values. 

Special File Associated 

Name DC 



OUTPUT DC=LP 

PUNCH DC=PU 

PUNCHB DC=SB 

P8 DC=P8 
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p. Description 

DEP Indicates that routing of the file to the queue will be deferred 

to a later job step or end of job. If this parameter is speci- 
fied, the file will be created if it does not exist. DEF is 
not allowed if DC=IN. 

EC=xx Defines external characteristics for print- or punch-type files. 

For print-type files, xx may specify the following values. 

A4 ASCII 48- character set 

A6 ASCII 64-character set 

B4 Display code 48- character set 

B6 Display code 63/64 -character^ set 

For punch-type files, xx may specify the following values. 

ASCII Punch ASCII 

026 Punch 02 6 mode 

029 Punch 029 mode 

SB Punch system binary 

80COL Punch 80 -column binary 



NOTE 



If the user includes the EC parameter on a 
ROUTE statement, the file queue processor 
may be unable to select that file for output. 
If EC is not specified, an appropriate EC 
default is established on the basis of the dis- 
position code (DC) and installation options. 
Accordingly, the EC parameter is not nor- 
mally specified. However, if the user does 
include this specification, the xx selected 
must be consistent with the queue file proc- 
essor (BATCHIO, EI200, RBF, etc. ). 

FC=xx Forms code; specifies that a special form must be placed in the 

output device. before the named file will be selected from the 
queue, xx can be any two alphanumeric characters, but the 
combinations null, AA, AB, AC, AD, AD, AE, and AF will give 
maximum system efficiency. A value of null results when no 
FC parameter is specified. 

FID=xx This is an NOS/BE parameter included for compatibility. It 

produces an informative message under NOS. 

FM Implicit remote routing (refer to the following note). 

FM=xx Family name; indicates routing to a remote terminal driven by 

EI200 or RBF. Normal default procedures apply if this parameter 
is not specified. 
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p^ Description 

IC=xx Internal characteristics; specifies one of the following. 



DIS 


Display coc 


ASCII 


ASCII code 


BIN 


Binary 



This parameter is normally not specified since its default is 
automatically established through the disposition code DC. 

ID=xx Selects local device ID from to 67 (octal default). (This is 

similar to the ID specified formally by the SETID control 
statement. ) 

ID Implicit central site routing (refer to the following note). 

PRI=xx File priority. This is an NOS/BE parameter included for 

compatibility. It produces an informative message under NOS. 

REP=xx Specifies a file repeat count from to 31 (decimal default). 

Values beyond this range are set to zero (default), and an 
informative message is issued. The value zero is handled 
internally to produce one listing. 

SC=xx Spacing code for the 580-PFC printer. This is a numeric 

value from to 77 (octal default). 

ST=xx Station ID. This is an NOS/BE parameter included for 

compatibility. It produces an informative message under 
NOS. 

TID Implicit remote routing (refer to the following note). 

TID=C Central site routing. This is an NOS/BE parameter included 

for compatibility. Its action is identical to the ID parameter. 

TID=xx Terminal ID. This form of the TID parameter is included 

for NOS/BE compatibility. Under NOS, it is processed the 
same as TID; however, an informative message is issued 
stating that xx is ignored. 

UN Implicit remote routing (refer to the following note). 

UN=xx Specifies the user number of the remote batch user to whom 

the named file is routed. The parameter xx is valid only if 
it matches the user number of the user performing the route. 
The matching is character for character except for those 
positions containing an * (refer to the following note). 
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I NOTE | 

For jobs of EIOT origin, the following action is taken. 

• Parameter ID, ID=xx, or TID=C will cause routing 
to the central site. 

• Parameter FM, TID, or UN with no argument will 
cause routing to the terminal of origin. 

• The omission of FM , TID, or UN will cause routing 
to the terminal of origin. 

• Parameter FM or UN with legal arguments will 
cause routing to the specified terminal. 

For jobs of any origin other than EIOT, the following action 
is taken. 

• Parameters ID, ID=xx, and TID=C will cause routing 
to the central site. 

• Specifying UN, TID, or FM without parameters will 
cause routing to the terminal specified by the job's 
FM and UN at the time of the ROUTE call. 

• Specifying UN or FM with legal arguments will cause 
routing to the selected remote terminal. 



If a job is routed to the input queue with an illegal USER control statement, the following 
message is issued 

DSP - ILLEGAL USER CARD. 
SYSTEM ABORT. 

and the job is aborted with no error exit processing or if submitted from a terminal, the 
terminal is logged off. The security count for the user number that did the ROUTE will be 
decremented accordingly. 

SETID STATEMENT* 

The SETID control statement assigns a new identification code for the specified file. 

The control statement format is: 

SETID(lfn 1 =x 1 , lfn 2 =x 2 , .... lfn n =x n ) 

lfn. Logical file name 

x. New identification code for the file (0 through 67p). This code 

1 must match the device identification code specified in the EST. 

(The installation establishes the device identification codes. ) 

The identification code allows the user to route his file to an output device or device 
group with the same identification code. This is useful when a print file requires 
special forms. 

The file lfni must be an input (INFT), local (LOFT), print (PRFT), or punch (PHFT) type 
file, or the following message is issued. 

ILLEGAL FILE TYPE. 



t The ROUTE control statement should be used to perform this operation. 
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SKIPEI STATEMENT 

The SKIPEI control statement directs the system to position the specified file at the EOI. 
The control statement format is: 
SKIPEI(lfn) 

lfn Name of the file to be positioned 

On- magnetic tapes where no EOI is defined, the operation stops at an EOF. 

The SKIPEI statement has no effect on a primary file since the file is rewound before every | 
operation. 

SKIPF STATEMENT 

The SKIPF control statement directs the system to bypass, in a forward direction, the 
specified number of files from the current position of the named file. 

The control statement format is: 

SKIPF(lfn, n, m) 

lfn Name of the file to be positioned 

n Number (decimal) of files to be skipped; if the parameter is 

omitted, the system assumes n=l. 

m File mode; C for coded, B for binary. If omitted, the system 

assumes the file is in binary mode. 

If an EOI is encountered before n files are bypassed, file lfn remains positioned at 
the EOI. 

The SKIPF statement has no effect on a primary file since the file is rewound before every | 
operation. 

SKIPFB STATEMENT 

The SKIPFB control statement directs the system to bypass, in the reverse direction, the 
specified number of files from the current position of the named file. 

The control statement format is: 

SKIPFBUfn, n, m) 

lfn Name of the file to be positioned 

n Number (decimal) of files to be skipped; if the parameter is 

omitted, the system assumes n=l. 

m File mode; C for coded, B for binary. If omitted, the system 

assumes the file is in binary mode. 
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The system does not backspace past the beginning-of -information (BOI), in the event that 
BOI is encountered before n files are bypassed. 

I The SKIPFB statement has no effect on a primary file since the file is rewound before every 
operation. 

SKIPR STATEMENT 

The SKIPR control statement directs the system to bypass, in a forward direction, the 
specified number of logical records from the current position of the named file. 

The control statement format is: 

SKIPR(lfn,n,je,m) 

lfn Name of the file to be positioned 

n Number (decimal) of records to be skipped; if this parameter 

is omitted, the system assumes n=l. 

St EOR level; 0<fl <17. If 0<£ <16, the system assumes S. =0. 

If £=17, n indicates the number of files to skip rather than records. 

m File mode; C for coded, B for binary. If omitted, the system as- 

sumes the file is in binary mode. 

EOR marks are considered separate records and included in the record count. If the EOI is 
encountered before n records are bypassed, file lfn remains positioned at the EOI. 

I The SKIPR statement has no effect on a primary file since the file is rewound before every 
operation. 

SORT STATEMENT 

The SORT control statement enables the user to sort a file of line images or statements in 
numerical order based on leading line numbers consisting of a specified number of digits. 

The control statement format is: 

SORT(lfn,NC=n) 

lfn Logical file name of the file to be sorted; lfn may be a local 

file or a direct access permanent file. 

n Number of leading line number digits the file is to be sorted 

on; n < 10. If the NC parameter is omitted, the system 
assumes n=5. 

In the case of duplicate line numbers, all lines other than the first are considered 
correction lines. All lines with the same number are deleted from the file except the 
last line encountered. 
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For input from a time-sharing terminal, SORT deletes a line image or statement if a 
line number is followed by an empty line or a line number is followed by a blank and 
a carriage return. 

For batch input, SORT deletes a statement or line image if a card containing only the 
line number is submitted. 

If a line number contains more than n digits, the user can delete the line either by 
entering the first n digits of the line number and pressing the carriage return (terminal 
input) or by submitting a card containing only the first n digits of the line number (batch 
input). 

After the sort, lfn is packed and set at EOI. 

The following SORT error messages may be issued to the user's dayfile. 



Message 
NO LINE NUMBER ON SORT FILE. 

ILLEGAL SORT PARAMETER. 

EMPTY SORT INPUT FILE. 

WRITE ON READ-ONLY FILE fff 
AT nnn. 



Description 

A line on the input file is missing a line 
number or a line exceeded the 150-char- 
acter limit. 

The SORT control statement is in error. 

File lfn contains no data. 

The direct access input file was not attached 
in write mode (refer to ATTACH Statement, 
section 8). 
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STAGE STATEMENT 

The STAGE control statement causes files to be copied from the specified device to a file 
residing on mass storage. 

The control statement format is: 

STAGEdfn, p x , p 2 , . . . , p n ) 

lfn Name associated with file to be staged from magnetic tape to 

mass storage 

p. Any of the following in any order: 

NR Do not rewind lfn before beginning operation; 

default is rewind. 

NU Do not unload lfn after staging operation; de- 

fault is automatic unload. 

DR Drop job after staging operation. 

N=n Copy n files to lfn. 

T=xx Stage file lfn from device with EST ordinal 

xx. t This parameter is specified only when 
tape containing files to be staged is unlabeled 
(X format and system default density). 

VSN=vsn Specifies the 1-to 6-character volume serial 
number of the labeled tape containing the file 
to be staged 

D=den Tape density: 

200 200 bpi (implies 7-track) 

556 556 bpi (implies 7-track) 

800 800 bpi/cpi (7- or 9-track) 

1600 1600 cpi (implies 9-track) 

F=format Data format (refer to section 10): 
I Internal 

X External 

SI System Internal tt 

MT 7-track tape (default) 

NT 9-track tape 

If T is not included but VSN is. included, n files are copied from the specified tape. If 
neither T nor VSN is included, a request for lfn is issued to the operator. If DR is 
not included, STAGE requests the next set of parameters for the next staging operation 
to be entered by the K display on the system console. When lfn is staged to mass 
storage, it is designated as a library file. If a library file already exists with the 
same name as the file being staged, the system issues the following message. 

DUPLICATE NAME. 

|. Contact installation personnel for a list of EST ordinals. 



I tt NOS/BE system default tape format. 
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TDUMP STATEMENT 

The TDUMP control statement lists a file in octal and /or alphanumeric form. 

The control statement format is: 
TDUMP( Pl ,p 2> . 



Pn> 



Pi 



Any of the following in any order: 



I=lfn x 

L=lfn 2 

O 



R=r count 



F=fcount 



N=lines 



NR 



Input file name (default is TAPED 

Output file name (default is OUTPUT) 

Octal dump only (default is octal and 
alphanumeric dump) 

Alphanumeric dump only (default is octal 
and alphanumeric dump) 

Number of records in decimal to dump 
(default is dump to EOI) 

Number of files in decimal to dump (default 
is dump to EOI). If F=0, dump continues 
until an empty file (double EOF) is en- 
countered. 

Maximum number of lines in decimal that 
can be dumped (if N is omitted, there is 
no restriction on the number of lines). 

Do not rewind file lfn^ before dump (de- 
fault is to rewind lfn^). 



The user has the option of dumping the entire file or of specifying the number of 
records, files, or lines to dump. 
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UNLOAD STATEMENT 

The UNLOAD control statement releases job attachment and/or the file space of the specified 
file. 

The control statement format is: 

UNLOADOfiij, lfh 2 . .... lfn n ) 

lfn. Name(s) of the file(s) to be unloaded 

The UNLOAD statement performs the same function as the RETURN control statement (for 
additional information, refer to the description of the RETURN statement earlier in this 
section). Unlike the RETURN statement, an UNLOAD of a magnetic tape file cannot be used 
to decrease the number of tape units scheduled for the job via the RESOURC control 
statement. For magnetic tape files, if the previous operation was a write, the UNLOAD 
statement causes the following operations to be performed. 

1. If the tape is ANSI labeled, the system writes a tape mark, an EOF1 label, 
and three tape marks and then unloads the tape. 

2. If the tape is unlabeled and the data format specified on the ASSIGN, LABEL, 
or REQUEST card is X, S, L, E, B, or F, the system writes four tape marks 
and then unloads the tape. 

3. If the tape is unlabeled and the data format is I or SI, the system writes a 
tape mark, an EOF1 label, and three tape marks and then unloads the tape. 

Refer to Tape Management control statements, section 10 for further information about tape 
files and to appendix G for a description of an EOF1 label. 

UNLOCK STATEMENT 

The UNLOCK control statement rescinds the LOCK command and clears the write interlock 
bit for the specified file. 

The control statement format is: 

UNLOCKdfn, , lfn , . . . , lfn ) 
1 Z n 

lfn. Name(s) of local file(s) 

The file must be a local file; if it is not, the following message is issued. 

ILLEGAL FILE TYPE. 
Common files cannot be unlocked. 
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VERIFY STATEMENT 

The VERIFY routine performs a binary comparison of all data from the current position 
of the files specified. 

The control statement format is: 

VERIFY(lfni, lfn 2 , Pi, P2, • • • , P n > 

lfn. Name of the first file; if this parameter is omitted, the 

system assumes TAPE1. 

lfn 2 Name of the second file; if this parameter is omitted, the 

system assumes TAPE2. 

p. Any of the following in any order: 

N=0 Verify terminates on the first empty file en- 

countered on either file. 

N=x Verify x files; default is N = l. 

N Verify terminates when end of information is 

encountered on either file. 

E=y List the first y errors encountered on the 

comparison. If E is omitted, the system 
assumes E = 100. 

E Same as E=0, no errors are listed. 

L=lfn„ List errors on file lfno. If L is omitted, the 
system assumes L OUTPUT. 

A Abort if errors occur. 

R Rewind both files before and after the verify. 

C Use coded file mode for SI, S, and L format 

coded tapes. 

Whenever words on the two files do not match, VERIFY lists the: 

• Record number 

• Word number within the record 

• Words from both files that do not match 

If errors are encountered, the following message is issued to the user's dayfile. 

VERIFY ERRORS. 
If any pair of lfnj, lfn2, and lfng are identical, the following message is issued. 

FILE NAME CONFLICT. 
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VFYLIB STATEMENT 

The VFYLIB control statement performs a binary comparison of two specified files after 
rewinding both files. 

The control statement format is: 

VFYLIBdfnj, lfn 2 , lfn 3 , NR) 

lfn 1 Name of the first file; if this parameter is omitted, the system 

assumes OLD. 

lfn~ Name of the second file; if this parameter is omitted, the system 

assumes NEW. 

lfn„ Name of the file to receive output; if this parameter is omitted, 

the system assumes OUTPUT. 



NR 



If specified, lfn 1 and lfn„ are not rewound. 



The VFYLIB program lists 

• Replacements 

• Deletions 

• Insertions 

on the output file lfn3. A program is defined as being replaced when the actual binary code 
is changed. Information in the prefix (77) table such as last modification date and last 
assembly date is skipped in VFYLIB's comparison. 

WRITEF STATEMENT 

The WRITEF control statement directs the system to write a specified number of file 
marks on the named file. 

The control statement format is: 

WRITEF(lfn, x) 

lfn Name of the file to be written on 

x Number of file marks to be written; if this parameter is 

omitted, the system assumes x=l. 

WRITER STATEMENT 

The WRITER control statement directs the system to write a specified number of empty 
records on the named file. 

The control statement format is: 

WRITER(lfn,x) 

lfn Name of the file to receive the empty records. 

x Number of empty records to be written; if this parameter is 

omitted, the system assumes x=l. 
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PERMANENT FILE CONTROL STATEMENTS 8 
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The permanent file control statements allow the user to utilize the permanent file system, f 
The control statements included in this category are: 

APPEND DEFINE PERMIT SAVE 

ATTACH GET PURGALL 

CATLIST OLD PURGE 

CHANGE PACKNAM REPLACE 

The statements described in the following section allow the user to create permanent files 
(DEFINE) and make local files permanent (SAVE, REPLACE). These files can be _ 

accessed (ATTACH, OLD, GET), added to (APPEND), and released (PURGE, PURGALL). I 
Requests are directed to a specified auxiliary device by the PACKNAM statement. Certain 
parameters can be changed with the CHANGE statement without attaching and redefining 
the file or retrieving and saving it. 

Information on permanent files is obtained through the CATLIST statement. Part of that 
information is the permission status of the user as granted by another user by means 
of the PERMIT statement. 

The following pages list options available on the control statements. Unless otherwise 
stated, the options described apply to all of the permanent file control statements. For 
a detailed description of permanent file structure, refer to section 2. Errors en- 
countered during permanent file control statement processing cause error messages to be 
issued to the user's dayfile. For a description of these messages, refer to appendix 
B. 



t The batch user is unable to access permanent files unless he has included a 
USER statement in the job deck. 
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Keyword 

UN = 



Option 



usernum 



Description 

Alternate user number. This parameter is 
necessary only if the permanent file involved 
resides in another user's catalog. To be able 
to access other catalogs, the. user must be 
granted explicit permission (refer to the PERMIT 
control statement), the file must be a semiprivate 
or public file, or the user must have automatic 
permission. A user has automatic permission to 
files in catalogs of other users if his user number 
contains asterisks, and all nonasterisk characters 
match the other user's user number. 



PW = 



passwrd 



The user has the option of specifying a l-to-7- 
character password for a file. This password 
must be specified whenever alternate users access 
thje file. 



PW 



CT = 



ct 



The user has the added security of specifying 
a 1- to 7- character password for a file by 
including it as a single- line record in the 
INPUT file. This password must be specified 
whenever alternate users access the file. 

Permanent files fall into three categories which 
specify the method of access. This option must 
be selected when the file is saved or defined. 
The categories are: 

P Private files are available for 

or access only by the originator or 

PRIVATE those to whom the originator has 
explicitly granted permission (refer 
to the PERMIT control statement). 

S Semiprivate files are available for 

or access by all users who know the 

SPRIV file name, user number, and pass- 
word. The system records in the 
originator's catalog the user num- 
ber of each user who accessed the 
file, the number of accesses, and 
the date and time of the last access. 

.PU Public files t are available for 

or access by all users who know the 

PUBLIC file name, user number, and pass- 
word. The system records the 
number of times the file was 
accessed but does not record user 
numbers or the last access date 
and time. 



tCT=LI can also be used to specify public files. 
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Keyword 

M = 



Option 



m 



Description 

File or user permission mode: 

W Allows the user to write, read, 

or append, execute, modify, and/or 

WRITE purge the file. This mode can be 

specified for direct or indirect 

access files. 

M Allows the user to modify, append, 

or read, and/or execute a direct 

MODIFY access file. Adding new informa- 

tion within the existing boundaries 
of the file is legal but the file 
size must be maintained. 

A Allows the user to append infor- 

or mation to the end (EOI) of the file. 

APPEND This mode can be specified for 

direct or indirect access files. 

R Allows the user to read and/or 

or execute the file. This mode can 

READ be specified for direct or indirect 

access files. 

RM Allows the user to read and/or 

or execute a direct access file with 

READMD the implication that another user 

may currently be accessing the same 
file in MODIFY mode. This 
mode can be specified only for 
direct access files. 

RA Allows the user to read and/or 

or execute a direct access file with 

READAP the implication that another user 
may currently be accessing the 
same file in APPEND mode. This 
mode can be specified only for 
direct access files. 

E Allows the user to execute the file, 

or If the file is attached to the user's 

EXECUTE job in EXECUTE mode, the file 

must be in absolute format. This 
mode can be specified for direct 
or indirect access files. Relocat- 
able files with EXECUTE permission 
may be loaded and executed only via 
a stand-alone file name call (such 
as LGO) which is not preceded by 
a loader control statement. 

N Removes permission previously 

or granted via PERMIT control 

NULL statements. This mode can be 

specified for direct or indirect 

access files. 
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Keyword 
R = 



Option 



Description 

Specifies the type of device on which the permanent 
file resides or is to reside; r can be any of the 
following. 

Device 



r 
DE 

Dli 

DJi 

DP 

MDi 



Extended Core Storaget 

844-21 Disk Storage Subsystem 
(l<i<8) 

844-41/44 Disk Storage Subsystem 
(l<i<8) 

Distributive Data Path to ECSt 

841 Multiple Disk Drive (l<i<8) 



S = 



PN = 



space 



packname 



The R keyword can be used in two ways. 

1. It can be used on the DEFINE control statement 
to specify the family device on which the direct 
access permanent file is to reside. 

2. It can be used in conjunction with the PN 
and NA keywords on any permanent file con- 
trol statement (including DEFINE) to identify the 
auxiliary device on which the permanent file 
resides or is to reside. R is required only 

if the desired device has a device type 
different from that of the default device type 
and the installation has defined the desired 
device as removable. If PN and NA are 
specified but R is not specified, the system 
default device type is used. If the specified 
device type cannot be recognized or does 
not exist in the system, the following 
message is issued to the user's dayfile. 

ILLEGAL DEVICE REQUEST, AT nnn. 

Specifies the amount of space in decimal PRUs 
desired for the direct access file. Refer to the 
DEFINE control statement. 

A 1- to 7- character pack name used in conjunction 
with the R keyword to identify the auxiliary device 
to be accessed in the permanent file request. This 
parameter is specified only when the file to be accessed 
resides on an auxiliary device. If the device is 
currently not available and the NA keyword was not 
specified, the following message is issued to the 
user's dayfile. 

DEVICE UNAVAILABLE, AT nnn. 

An auxiliary device is a mass storage device that 
supplements the normal family of permanent file 
devices. A RESOURC control statement must be 
included in any job that uses two or more disk 
packs concurrently. 



I t The job must be of system origin or the user must be validated for system origin privileges. 
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Keyword 

NA 



Option 



ND 



Description 
The NA keyword can be used in two ways. 

1. Normally, if the user attempts to access 
a file that is interlocked or if an error 
occurs in an attempt to process the file, 
the system aborts the job. With the 

NA option, the user can bypass a job abort 
and continue processing. If lfn is busy and 
the NA option is specified on an ATTACH 
control statement, the system automatically 
suspends the job until the file becomes avail- 
able. If NA is specified and an error other 
than pfn BUSY occurs in processing file 
Ifni, the system issues the appropriate 
error message to the user's dayfile and then 
continues with file lfrii+i. If the error 
occurred on the last file specified on the 
statement, the system continues with the 
next statement. 

2. If the user requests an auxiliary device 
that is currently not available, the system 
aborts his job. The NA keyword enables 
him to bypass this abort and direct the 
system to make the desired device available. 

The ND keyword prevents releasing of the user's 
working files upon processing of an OLD control 
statement. 



Several files can be accessed with one control statement. A slash (/) is used to separate 
the files being accessed and the options described previously. The special options 
are order-independent and are indicated by the keywords described. If special options 
are specified on the control statement, they apply to all files that appear on the statement. 

APPEND STATEMENT 

The APPEND control statement allows the user to add supplementary information to an 
existing indirect access file. 

The control statement format is: 

APPEND(pfn, lfni, lfn 2 , . . . , lfn n /PW=passwrd, UN=usernum, PN=packname, R=r, NA) 

pfn Name of the indirect access permanent file to which the 

local files are to be appended 

lfn^ Name(s) of local file(s) to be appended to pfn 

The logical structure of the two files is retained; that is, EORs and EOFs are appended 
as well as data. If the file is appended to a file in an alternate user's catalog, a 
password must be supplied if one is required. 
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ATTACH STATEMENT 

The ATTACH control statement allows a user to access a direct access file. 
The control statement format is: 

ATTACH(lfn 1 =pfn 1 ,lfn 2 =pfn2, . . . , lfn n =pfn n /UN=usernum, PW=passwrd, M=m, 
PN=packname, R=r, NA f 

lfn. Local file name given to the direct access file while it is attached 

to the user's job. A working copy is not generated 
since user access is made directly to the permanent file. 
Thus, lfnj is used only when it is desirable to reference the 
attached file by a name other than its permanent file name, 
pfni. 

pfnj Name of direct access file to be attached. If pfn. is omitted, 

the system assumes pfn^lfn^. 

m File or user permission mode, where m can be W, M, A, E, 

R, RM, or RA. If m is omitted, the system assumes m is 
R. This option must be specified by all users, including the 
originator, if the file is to be modified or new information is 
to be added to the file. If pfn^ is attached in W mode, the 
date is recorded as last modification date even if the file 
was not altered. 

A read/write interlock controls multiple access of a direct access file. The main purpose of 
this interlock is to ensure that only one user at a time writes on the file; however, it is 
possible for several users to read a file simultaneously. 

Table 1-8-1 gives combinations of multiple access. The left column specifies the current 
access status of the file, and the top row indicates the type of access a user is requesting on 
an ATTACH statement with the M parameter. The entries in the table are the access modes 
actually granted. The access a user is granted is contingent on having been permitted that 
mode of access by the creator of the file. 
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TABLE 1-8- 


1. COMBINATIONS OF MULTIPLE ACCESS 






Current 
Access 


Access Requested 


Free 




W 


M 


A 


R 


RM 


RA 




E 


W 




Busy- 


Busy 


Busy 


Busy 


Busy 


Busy 




Busy 


M 




Busy 


Busy 


Busy 


Busy 


M/R 


Busy 




Busy 


A 




Busy 


Busy 


Busy 


Busy 


A/R 


A/R 




Busy 


R 




Busy 


Busy 


Busy 


R 


R 


R 




R 


RM 




Busy 


M/R 


A/R 


R 


R 


R 




R 


RA 




Busy 


Busy 


A/R 


R 


R 


R 




R 


E 




Busy 


Busy 


Busy 


R 


R 


R 




R 


NOTES: 










W, M, A, 


R, 


RM, RA, and E have the values described under the 


M= keyword. 


Busy indicates 
effect. 


the requested access is not allowed while the current 


access is in 


A/R is the 
mode, and 


ace 
one 


ess condition in which one user has attached the file 
or more other users have attached it in read mode. 


in append 


M/R is the 
mode, and 


access condition in which one user has attached the file 
one or more other users have attached it in read mode. 


in modify 



The user should return a file as soon as possible since this usually increases the 
availability of the file to other alternate users. 

If an auxiliary device has been previously specified by a PACKNAM statement, the 
system attempts to attach pfn. from the auxiliary device rather than the normal system 
devices. 1 
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CATUST STATEMENT 

The CATLIST control statement lists information about the user's permanent files or 
those permanent files he can access in the catalogs of alternate users. 

The control statement format is: 

CATLIST (LO=p, FN=pfn, UN=usernum, PN=packname, R=r, L=lfn, NA, DN=dn) 

p One of the following list options: 

F Selects a listing of pertinent information about 

each file in the user's catalog. If an alternate 
user number is specified (UN option), the user 
obtains a listing of all files that he can access 
in the alternate user's catalog. Note that the 
password for files in an alternate user's catalog 
is not included in the listing. The password to 
files in an alternate user's catalog must be ob- 
tained directly from that user. 

FP Selects a listing of permission information 

recorded for each alternate user of a specified 
file in the user's catalog. This option requires 
that a file name be specified (FN option). If 
an alternate user number is specified (UN option), 
only the permission information for that user of 
the specified file is listed. 

The user numbers listed include those that have 
been granted explicit permission to the file 
(private file only) and those that have accessed 
the file because of implicit permission (semiprivate 
files onlyht 



Selects a short list that includes only 

(zero) the names of the files in the user's 
catalog. If an alternate user number 
is specified (UN option), the user ob- 
tains only the names of the files that 
he can access in the alternate user's 
catalog. If no LO keyword is speci- 
fied, the system assumes this value. 

P Selects a short list that indicates only 

the user numbers of alternate users 
who have accessed the specified pri- 
vate or semiprivate file. This option 
requires that a file name be specified 
(FN option). 



TUser numbers are not recorded for accesses to public files 
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pfn 



usernum 



packname 



lfn 



Permanent file name. This option specifies that catalog 
information is desired only for this permanent file. This 
parameter is required when listing permit information 
(LO=FP, LO=P). If the short list options are selected 
(LO=0, LO=P), the message 

pfn FOUND, AT nnn. 

is issued if the file (or user number) is located. The 
message 

pfn NOT FOUND, AT nnn. 

is issued if the specified file (or user number) is not located. 

User number. This parameter has two purposes. 

1. For LO=F and LO=0. Indicates the alternate catalog 
for which the user desires catalog information. 

2. For LO=FP and LO=P. Indicates the permission 
information recorded for the specified alternate user. 

This parameter specifies an auxiliary device that contains 
catalog information for all users with files on that device. 
The PN keyword must be specified if the user wishes to 
obtain the following information from his catalog on the 
specified auxiliary device. 

• Pertinent information about each file (LO=F) 

• Only the name of each file (LO=0) 

• Permission information for each alternate user that 
has accessed a specific file (LO=FP) 

• Only the user number of each alternate user that 
has accessed a specific file (LO=P) 

The PN parameter can also be specified to allow alternate 
users to obtain a list of files they can access on the auxiliary 
device, as well as pertinent information about each file. 

Output file name. This is the name of a local file to which 
the CATLIST information is written. If this parameter is 
omitted, the system assumes L=OUTPUT. If lfn exists and 
is positioned at BOI, the contents of that file is purged be- 
fore the -CATLIST information is written. However, if lfn 
exists and is positioned at EOI, the CATLIST information is 
appended to the file as a new logical record. 
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NA No abort option. CATLIST continues processing if errors 

are encountered during processing. 

dn Device number (0 through 77s). List file residing on 

specified device number dn. 

If no entries are present in the specified catalog, the message 

EMPTY CATALOG. 

is issued to the ustr r s dayfile. 

CHANGE STATEMENT 

The CHANGE control statement allows the originator of a direct or indirect access file to 
alter any of several parameters without having to attach and redefine the file or re- 
trieve and save it. 

The control statement format is: 

CHANGE (nfn=ofn/CT=ct, M=m, PW=passwrd, PN=packname, R=r, NA) 

nfn New permanent file name 

ofn Old permanent file name. If no name change is desired, 

only ofn is specified. 

The CT, M, and PW keywords should be specified only if a change in the value asso- 
ciated with that keyword is desired. To clear the password for an existing file, the 
user must set PW=0. The PN and R keywords cannot be used to specify a new auxiliary 
device. They are used only to specify the device on which ofn resides. CHANGE also 
updates the last modification date and last access date for the specified file. 

The following messages may be issued to the user's dayfile in response to a CHANGE 
request. 

Message Description 

ofn NOT FOUND, AT nnn. The specified permanent file, ofn, was not 

found in the user's catalog. 

nfn ALREADY PERMANENT, The new permanent file, nfn, already exists 

AT nnn. in the user's permanent file catalog. 
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DEFINE STATEMENT 

The DEFINE control statement allows the user to define direct access permanent files. 
The control statement format is: 

DEFINE(lfn 1 =pfn 1 , lfn 2 =pfn 2 , . . . , lfn n =pfn n /PW=passwrd, CT=ct, M=m, R=r, 
S=space, PN=packname,NA) 



lfn. 



pfn i 



If DEFINE is to be used to create an empty direct access 
permanent file, lfn^ is specified only if the user desires to 
reference the file by a name other than its permanent file name. 
If DEFINE is to be used to define an existing local file as a 
direct access file, lfn. is the name of the local file. Also, 
if lfn^ exists, its position is not altered. 

Permanent file name. If pfn^ is omitted, the system assumes 
lfn^pfn.. 

Type of device on which the permanent file is to reside. The 
device must be a permanent file mass storage device on which 
direct access files are allowed. 



The user can either create an empty permanent file or define an existing local file as 
a direct access file. If the user releases the file and wishes to access it at some 
time in the future, the ATTACH control statement must be included. 

If lfni does not exist, the device on which pfnj resides depends on the r and space 
parameters. 



Specified 
Specified 

Not specified 

Not specified 



space 
Not specified 

Specified 
Specified 
Not specified 



Residency 

The file resides on the device of type r with 
the most space available. 

The file resides on the device of type r with 
the most space available, provided that de- 
vice has as many PRUs available as specified 
by the space parameter. 

The file resides on the device with the most 
space available, provided that device has as 
many PRUs available as specified by the 
space parameter. 

The file resides on the device with the most 
space available. 



If an auxiliary device has been previously specified by a PACKNAM statement, pft^ resides 
on that auxiliary device rather than a system device. 

If the optional parameters are omitted, the system assumes the following values. 

Keyword Default 

PW None 

CT PRIVATE 

M WRITE 

PN None 
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If the S option is selected and no device has the specified amount of space available, the 
request is aborted and the following message is issued to the user's dayfile. 

PRUS REQUESTED NOT AVAILABLE, AT nnn. 

Unused space is not guaranteed to be available if the user attempts to expand the file 
at a later time. 

If lfn. already exists on a device other than that specified by r, or an illegal device 
is specified, the system issues the following message to the user's dayfile. 

DIRECT ACCESS DEVICE ERROR, AT nnn. 

GET STATEMENT 

The GET control statement enables the user to retrieve a copy of file pfnj for use as a 
local file. 

The control statement format is: 

GET(lfn 1 =pfn 1 , lfn 2 =pfn 2 , . . . , lfn n =pfn n /UN=usernum, PW= passwrd, PN=packname, 
R=r, NA) 

lfn^ Local file name given the file while in use 

pfn^ Permanent file name; if pfn. is omitted, lfn. = pfn. 

If the request is made with no parameters specified, the user's primary file is assumed. 

Each pfn specified must be an indirect access file. File lfn^ is returned to the system 
if it is present before this command is issued even if an error is encountered in proc- 
essing the command. The new file is rewound. No interlock is provided to prevent 
other users from obtaining working copies of the same file simultaneously. If the name 
of the user's current primary file is specified as an lfn, the corresponding pfn is made 
the new primary file and any subsystem associated with it becomes the user's new cur- 
rent time-sharing subsystem. 

If the request is for a file in another user's catalog (UN option specified), the per- 
mission mode is that which the user has been permitted for private files or that speci- 
fied in the catalog for semiprivate and public files. 

If an auxiliary device has been previously specified by a PACKNAM statement, the sys- 
tem attempts to retrieve the copy of pfn^ from the auxiliary device rather than the 
normal system devices. 

OLD STATEMENT 

The OLD control statement retrieves a copy of a permanent file and makes it the 
primary file. 

The control statement format is: 

OLD(lfn=pfn/UN=usernum, PW=passwrd, PN=packname, R=r, NA, ND) 
lfn Local file name given the file while in use 

pfn Permanent file name. If pfn is omitted, lfn=pfn. 
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The OLD statement performs the same operation as the GET statement and additionally 
makes lfn the primary file. Any currently existing primary file is released. All 
working files are also released unless the ND parameter is specified. 

If an auxiliary device has been specified previously by a PACKNAM statement, the 
system attempts to retrieve the copy of pfn from the auxiliary device rather than the 
normal system devices. 

Refer to the note in PRIMARY Statement, section 7 for use of primary file types. 

PACKNAM STATEMENT 

The PACKNAM control statement directs subsequent permanent file requests to the 
specified auxiliary device. 

The control statement format is: 
PACKNAM(PN=packname) 

or 
PACKNAM(packname) 

packname A 1- to 7- character name used to identify the auxiliary 

device to be accessed in subsequent permanent file requests 

PACKNAM allows the user to omit the PN keyword from requests for files that reside 
on the specified device. However, if permanent files on another auxiliary device are 
to be accessed, the PN keyword can be specified in the request or another PACKNAM 
request can be issued. Refer to Device Residence, section 2 for information concerning 
auxiliary permanent file devices. 

The user cannot access permanent files residing on the normal system devices while 
the PACKNAM request is in effect. To access these files, he must include a PACK- 
NAM card in either of the following formats. 

PACKNAM 

or 

PACKNAM(PN=0) 



60435400 C 1-8-13 



PERMIT STATEMENT 

The PERMIT control statement allows a user to explicitly permit another user to access a 
private file in his permanent file catalog. 

The control statement format is: 

PERMIT(pfn, usernumi=m 1 , usernum 2 = m2, . . . , usernum n =m n /PN=packname, R=r, NA) 

pfn Permanent file name 

usernum^ User number to be permitted access to pfn 

m. Permitted mode of access. If mj is omitted, the system 

assumes mode R. 

If pfn is a public file, the following message is issued. 

PFM ILLEGAL REQUEST, AT nnn. 

PURGALL STATEMENT 

The PURGALL control statement purges all permanent files in the user's catalog that 
satisfy the criteria specified by the parameters. 

The control statement format is: 

PURGALL(CT=ct, AD=ad, MD=md, CD=cd, DN=dn, T Y=ty, TM=tm, PN=packname, R=r, NA) 

ct File category 

ad Last access date; format of date is yymmdd 

md Last modification date; format is yymmdd 

cd Creation date; format is yymmdd 

dn Device number (0 through 77g). The device number is 

assigned during system configuration time when the device 
is defined. It uniquely identifies a device within a family. * 

ty File type: 

I 

or Purge all indirect access files 

INDIR 

D 

or Purge all direct access files 

DIRECT 

A 

or Purge all files 

ALL 

If this parameter is omitted but other parameters are 
specified, the system assumes ty is ALL. If no other 
parameters are specified and the user wishes to purge 
all files, he must specify TY=A. 

tm Time of day on the date specified by ad, md, or cd 

parameter. The time of day is expressed in the format 
hhmmss. 



' Refer to section 2 for further information about families of permanent file devices. 
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packname Name of auxiliary device on which the files to be purged 

reside. The PN option cannot be selected if a device 
number was specified. 

r Type of auxiliary device on which the files to be purged 

reside. The R option cannot be selected if a device 
number was specified. 

The AD, MD, and CD keywords are used to purge any files whose last access, last 
modification, or creation occurred before the specified date. To purge all files in 
his catalog, the user must enter: 

PURGALL(TY=A) 

CT, DN, TY, TM, and either AD, MD, or CD may be entered simultaneously. 

PURGE STATEMENT 

The PURGE control statement allows a user to remove a file from the permanent file device. 

The control statement format is: 

PURGE(pfni, pfn 2 , . . . , pfn n /UN=usernum, PW=passwrd, PN=packname, R = r, NA) 
pfn. Permanent file name 

If the request is made with no parameters specified, the user's primary file is assumed. 

When a PURGE command is issued for a direct access file which is not being used, 
the file is purged and the permanent file catalog altered accordingly. If the direct 
access file is in use, the catalog is altered to reflect purging of the permanent file 
but the actual file is not purged until the last user returns it. 

To purge a file in an alternate user's catalog, the user must have write permission 
or the file must be semiprivate or public with write mode. If pfn^ does not exist, 
the following message is issued. 

pfn NOT FOUND, AT nnn. 

REPLACE STATEMENT 

The REPLACE control statement enables the user to place a copy of a local file in the 
permanent file system as an indirect access file. 

The control statement format is: 

REPLACE(lfn^=pfni, Ifn2=pfn2, . . . , lfn n =pfn n /UN=usernum, PW=passwrd, 
PN=packname, R=r, NA) 

lfn. Local file name 

pfn^ Permanent file name. If pfn^ is omitted, lfn^=pfn^. 

If the request is made with no parameters specified, the user's primary file is assumed. 

If pfn^ already exists, it is purged and replaced by the new file. The new file is in 
the same category as the file it replaced. If pfn^ does not exist, the new file is saved 
as a private file. Permission information and alternate user access data for the file 
are not lost when a file is replaced. 

A user who has been granted write permission to another user's file can replace that 
file only if he is validated to create indirect access permanent files (refer to LIMITS 
control statement, section 6.) 
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SAVE STATEMENT 

The SAVE control statement allows the user to retain a copy of a local file as an indirect 
access file. 

The control statement format is: 

SAVE(lfni=pfn 1 , lfn2=pfn 2 , . . . , lfn n =pfn n /PW=passwrd, CT=ct, M=m, PN=packname, 
R=r, NA) 

lfn^ Local file name 

pfn^ Permanent file name. If pfn^ is omitted, the system 

assumes lfn^pfn^. 

If the request is made with no parameters specified, the user's primary file is assumed. 
If the name of the user's current primary file is specified as an lfn, the user's current 
subsystem is stored in the file's catalog entry. 

The local files are rewound when the save operation is completed. If the optional 
parameters are omitted, the system assumes the following values. 

Keyword Default 

PW None 

CT PRIVATE 

M WRITE 

PN None 

If an auxiliary device has been previously specified by a PACKNAM statement, the 
system saves pfn^ on the auxiliary device rather than a normal system device. 

If pfn^ already exists in the user's catalog, the following message is issued, 
pfn ALREADY PERMANENT, AT nnn. 
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LOAD/DUMP CENTRAL MEMORY 
UTILITY CONTROL STATEMENTS 



The load/dump central memory utility control statements allow the user to transfer infor- 
mation that resides in his job field length to a peripheral device or to transfer infor- 
mation from that device into central memory. The following statements are included in 
this category. 



DMP 


LOC 


RBR 




DMD 


PBC 


WBR 




LBC 










NOTE | 



For information concerning security restrictions 
associated with the use of these control state- 
ments, refer to Security Control, section 3. 

The DMP and DMD control statements dump central memory in octal representation and /or 
display code equivalences. These statements are particularly helpful in creating dumps for 
debugging purposes. (Refer to Debugging Aids, section 13. ) Other transfers of data from 
central memory use the PBC statement which dumps a binary record to PTJNCHB and the 
WBR statement which writes a binary record on a specified file. 

Data is loaded to central memory by the LBC, LOC, and RBR statements. The LBC con- 
trol statemen.t is useful in loading binary data in an unknown format. All numeric parameters 
may be expressed in octal. (postradix is B) or decimal (postradix is D) notation. If no 
radix is specified, octal is assumed. 



DMP STATEMENT 

The DMP control statement requests a dump on file OUTPUT of central memory in four 
words per line. 

The control statement format- is: 

DMP(fwa, lwa) or 

DMP(lwa) or 

DMP. 

fwa First word address of memory to be dumped; fwa is relative 

to RA. If fwa is absent, dump mode depends on presence or 
absence of lwa. 

lwa Last word address plus 1 of memory to be dumped; lwa is 

relative to RA. If lwa alone is present, DMP assumes 
fwa=0. If neither fwa nor lwa is present, DMP dumps the 
exchange package and 40 8 locations before and after the 
program address register in the exchange package. 

The DMP routine dumps on file OUTPUT central memory according to the DMP call 
parameters in four words per line. If, lines are duplicated, they are suppressed with 
the following notation. 

DUPLICATE LINES. 
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The DMP statement must immediately follow the program to be dumped, except that ^ 

another DMP, DMD, or EXIT statement may intervene. 

Dumping will always stop at FL if lwa > FL. If either fwa or lwa is nonnumeric, the 
request is interpreted as: 

DMP. 

If fwa > FL, fwa is set to FL-10 8 . If both fwa and lwa > FL, fwa is set-to FL-10 8 
and lwa is set to FL. If fwa=lwa, the system adds 10s to lwa and proceeds with the 
operation. If fwa > 4OOOOO3, the first dump address is fwa-4000008, memory from 
the first dump address through lwa is dumped, and the job is aborted. If fwa >.lwa, 
the system issues the following message to the user's dayfile. 

DUMP FWA .GE. LWA+1. 

Since the user's FL is not saved between commands entered from a time- sharing 
terminal, the only way to use DMP from a terminal is to call a procedure file. A dump 
from a terminal is formatted for 72 -column output. 

DMD STATEMENT 

The DMD control statement requests a dump similar to that of the DMP statement but 
additionally contains the display code equivalences to the right of the octal representations. 

The control statement format is: 

DMD(fwa,.lwa) or 
DMD(lwa) or 

DMD. 

fwa First word address of memory to be dumped; fwa is relative 

to RA. If fwa is absent, dump mode depends on presence 
or absence of lwa. 

lwa Last word address plus 1 of memory to be dumped; lwa is 

relative to RA. If lwa alone is present, DMD assumes 
fwa=0. If neither fwa nor lwa is present, DMD dumps the 
exchange package and 40 8 locations before and after the 
program address in the exchange package. 

The DMD statement is not allowed from a time- sharing terminal. 

LBC STATEMENT 

The LBC control statement is intended for loading binary data of unknown format. 

The control statement format is: 

LBC(addr) 

addr Address relative to RA at which binary load begins; if 

addr is omitted, (RA) is assumed. 

LBC reads only one record from file INPUT. The user must make an LBC call for each 
record of data to be loaded. If addr is specified in the program call, binary data is loaded 
beginning at that address; otherwise, loading begins at the reference address (RA). 
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The following messages may be issued to the user's dayfile in response to an LBC 
card. 



LBC ARGUMENT ERROR. 
LBC FWA .GE. FL. 

RECORD TOO LONG. 



The load address, addr, is nonnumeric. 

The load address is greater than or equal 
to the user's field length. 

The record is too long for available memory. 
Available memory is filled and the excess 
data is skipped. 



LOC STATEMENT 

The LOC control statement calls the LOC program and specifies address parameters used by 
LOC to read octal line images from file INPUT and enter them in CM. 

The control statement format is: 



LOC(fwa,lwa) 


or 


LOC (lwa) 


or 


LOC. 




fwa 





First word address of an area to clear (zero) before loading 
correction statements. If fwa is absent, LOC assumes 0. 



lwa 



Last word address plus 1 of the area to be cleared, 
is absent, LOC assumes 0. 



If lwa 



The correction statement images consist of octal address and data fields. The address field 
specifies the location to be corrected, and the data field contains the data to be placed in 
that location. Both fields may start at any column as long as the address precedes the data. 
The address field consists of a one- to six-digit address. If it is five characters or less, it 
is separated from the data field by a nonoctal character (for example, a blank). If it is six 
characters, no separator is required. 

The data field consists of 1 to 20 octal chracters. If it is less than 20 characters, it 

is terminated by a nonblank, nonoctal character and is stored right-justified. If it is 

20 characters, no terminator is required. Embedded blanks in the data field are ignored 

The following messages may be issued to the user's dayfile. 

LOC ARGUMENT ERROR. Either fwa or lwa is nonnumeric. 

LOC RANGE ERROR. Either fwa is greater than lwa or lwa is greater 

than FL. 



ADDRESS OUT OF RANGE, 
aaaaaa. 



The address aaaaaa on a correction statement is 
greater than or equal to the user's field length. 
The correction statement is ignored and LOC 
continues. 



If both addresses are specified and both are nonzero, storage is cleared from fwa to lwa 
and the octal line images are loaded at the specified addresses. LOC can be called to clear 
storage by providing an empty (zero-filled) record on file INPUT. 
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PBC STATEMENT 

The PBC routine writes one record from the specified area of CM to file PUNCHB. 

The control statement format is: 

PBC(fwa, lwa) or 

PBC(lwa) or 

PBC. 

fwa Address relative to RA at which the binary deck begins; if this 

parameter is omitted, the PBC operation depends upon the 
presence or absence of lwa. 

lwa Last word address plus 1 of the binary deck. If lwa alone 

is present, PBC assumes that fwa=RA. If lwa=fwa, and a 
nonzero value is specified, PBC adds 10 R to lwa. If fwa 
and lwa=0 or are omitted, RA contains lwa in the lower 18 
bits. If the upper 12 bits of RA are 7700 g , lwa is the lower 
18 bits of the location following the prefix (77) table plus the 
length of the prefix table. 

CM is not altered by PBC. 

The following messages may be issued to the user's dayfile. 

PBC ARGUMENT ERROR. Either fwa or lwa is nonnumeric. 

PBC FWA ,GT. LWA. The fwa parameter is greater than lwa. 

PBC RANGE ERROR. The lwa parameter is greater than or equal 

to the user's field length. 

RBR STATEMENT 

The RBR routine loads one binary record from a specified file. 
The control statement format is: 

RBR(n, name) 

n n is used in constructing -the name of the file containing 

the binary record to be read. If n is less than four char- 
acters and is numeric, TAPEn is the file name. If n 
contains a nonnumeric character or is four or more char- 
acters long, n itself is used as the file name. If n is 
absent, TAPE is the file name. 

nam e A 1- to 7-character name used in a record prefix. 
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The RBR routine loads one binary record from the specified file into central memory 
starting at RA. If the name parameter is included, a record prefix is placed in central J 
memory starting at RA. The record itself follows. The following is the format of the 
record prefix. 



RA 
RA+1 
RA+2 
RA+3 

RA+1 7 
RA+20 8 



59 53 



47 



35 



17 



77 



00 



0016 



name 



length 



date (yy/mm/dd. ) 



2> 



5200 



length 



length Record length including the prefix 

lengths Record length minus words RA through RA + 17s 

If the record is too long for available memory, memory is filled, excess data is skipped, 
and the following message is issued to the user's dayfile. 

RECORD TOO LONG. 



WBR STATEMENT 

The WBR routine writes a binary record from CM to a file at its current position. 
The control statement format is: 



WBR(n.rl) 
n 



rl 



n is used in constructing the name of the file on which the 
binary record is to be written. If n is less than four 
characters and is numeric, TAPEn is the file name. If 
n contains a nonnumeric character or is four or more 
characters long, n itself is used as the file name. If n 
is absent, TAPE is the file name. 

Record length in words. If rl is or absent, the length 
is taken from the lower 18 bits of RA. 



WBR begins writing from RA. 
The following messages may be issued to the user's dayfile. 

WBR ARGUMENT ERROR. The rl parameter is nonnumeric. 



RECORD TOO LONG. 



The rl parameter is greater than or equal to 
the user's field length. 
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TAPE MANAGEMENT 



10 



This section is devoted primarily to the control statements necessary to create and manage 
files on magnetic tape. Following the control statements are descriptions of the various 
types of tape formats available to the user. 



The control statements described in this section are: 



ASSIGN 
BLANK 
LABEL 



LISTLB 
REQUEST 

VSN 



The ASSIGN, LABEL, and REQUEST control statements cause files to be assigned to tape 
units or devices. The REQUEST statement requires operator action unless the VSN is 
specified. In this case, if the tape has already been mounted, assignment is automatic . 
LABEL and ASSIGN also cause automatic assignment. 

ANSI tape labels can be read using the LISTLB statement and blank -labeled for installation 
control using the BLANK statement. 

The control statements available to the user for assigning a file to magnetic tape are also 
used to create new and access existing 7- and 9-track labeled and unlabeled tapes. 
The following terms are used in describing these statements. 



Volume 

Volume serial number 

Block 



Reel of magnetic tape 

Number that uniquely identifies a reel of tape 

One physical record unit (PRU); that is, a group of 
contiguous characters recorded on and read from 
magnetic tape as a unit. 



Noise 
Label 



Tape mark 
Owner 

NOS written tape 



Any block less than the minimum acceptable block size 
is considered noise and discarded by the system. 

Field of characters that identifies and /or delimits a 
volume or file. Labels may be written in ANSI standard 
or nonstandard format. ANSI labels are 80-character 
blocks recorded at the beginning of a volume (VOL1), 
the beginning of a file (HDR1), the end of a file (EOF1), 
and the end of a volume (EOV1). Labels which do not 
conform to ANSI standards in format and /or content 
are defined as nonstandard. 

Special configuration recorded on magnetic tape indicating 
the boundary between files and /or labels 

Owner of a NOS written tape identified in the VOL1 
label by the combination of his family name and 
user number 

Tape with ANSI labels written by NOS and identified 
as such in the system code field of each HDR1, 
EOF1, and EOV1 label 
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The format and contents of ANSI labels are described in appendix G. A RESOURC 
control statement must be included in any job that uses two or more tape units con- 
currently. 

The following is a list of the parameters that may appear on one or more of the tape 
management control statements. 



Keyword Parameter 



ccount 



Default 



None 



CB 



Refer to 

REQUEST 

statement. 



Valid On Description 

ASSIGN Character count. Specifies 

REQUEST the maximum size block (in 6- 
bit characters) that may be 
read or written. This param- 
eter applies only to E, B, and 
F data formats (refer to the F 
keyword). 

ASSIGN Specifies that lfn is to be used 

LABEL as a checkpoint file. Each 

REQUEST time a checkpoint dump is 

taken, the new information is 
written at the BOI of lfn. 



CK 



CR = 

or 

C= 



cdate 



Refer to 

REQUEST 

statement. 



Current date 



ASSIGN 
LABEL 
REQUEST 



LABEL 



Specifies that lfn is to be used 
as a checkpoint file. Each 
time a checkpoint dump is 
taken, the new information is 
written at the previous EOI of 
lfn. 

Creation date in the form yyddd 
where 1< ddd< 366. Creation 
date is meaningful only on read 
operations; on write operations, 
the current date is always used 
(refer to appendix G, HDR1 
label). 



CV= 
or 

N= 



conv 



Installation 
parameter 



ASSIGN 
BLANK 
LABEL 
REQUEST 



Specifies the conversion f mode 
for 9 -track tapes: 

AS ASCII/display code 

conversion 
US Same as for AS 
EB EBCDIC/display code 

conversion 

For unlabeled 9 -track I or SI 
(internal) format tapes, con- 
version is always forced to 
ASCII. 



t Refer to ASCII/Display Code and EBCDIC/Display Code Conversion, appendix A. 
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Keyword 


Parameter 


Default 


Valid On 


Spec 


Description 


D= 


den 


Installation 


ASSIGN 


:ifies tape density: 






parameter 


BLANK- 
LABEL 
REQUEST 


LO 


200 bpi (7-track) 








HI 
HY 


556 bpi (7-track) 
800 bpi (7-track) 










HD 


800 cpi (9-track) 










PE 


1600 cpi (9-track) 










200 


200 bpi (7-track) 










556 


556 bpi (7-track) 










800 


800 bpi (7- or 9-track) 










1600 


1600 cpi (9-track) 



E = 



gvn 



Refer to 
appendix G. 



LABEL 1- to 2 -digit generation version 

number (refer to appendix G, 
HDR1 label). 



F= 



format I format for LABEL 

statement. I format 
for ASSIGN statement 
if VSN keyword is 
included; otherwise, 
default is X format. 
I format for REQUEST 
statement if VSN 
control statement has 
been processed; other- 
wise, default is X 
format. 



ASSIGN 
LABEL 
REQUEST 


Spec 

I 

X 

B 


ifies the data format 

Internal 

External 

Blocked 




E 

S 

L 

SI 

F 


Line image 

Stranger 

Long block stranger 

System internal t 

Foreign 



FA 



fa 



Unlimited access 



FC= 



f count 



None 



BLANK File accessibility. One char- 

LABEL acter that indicates who has 

access to the labeled file (refer 
to appendix G, HDR1 label). 

A Only the owner of the 

NOS written tape can 
access the file. 

omitted FA omitted indicates 

unlimited access. 

other All future accesses to 
this tape must specify 
this character as the 
fa parameter. 

File accessibility is not checked 
for system origin jobs. 

ASSIGN Frame count. Specifies the 

LABEL maximum size block (in frames) 
REQUEST that may be read or written. 

This parameter applies only to 
E, B, and F data formats 
(refer to the F keyword). 



t NOS/BE system default tape format. 
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Keyword Parameter 



Default 



Valid On 



Description 



FI= 

or 

L= 

G= 



HD 



HI 



HY 



L= 



fileid 



genno 



out 



Refer to 
appendix G. 



Refer to 
appendix G. 

Installation 
parameter 

Installation 
parameter 

Installation 
parameter 

OUTPUT 



LABEL A 1- to 17 -character file iden- 
tifier recorded in HDR1. 



LABEL 1- to 4 -digit generation num- 

ber (refer to appendix G, 
HDR1 label). 

ASSIGN 800 -cpi tape density (implies 

REQUEST 9 -track tape) 

ASSIGN 556 -bpi tape density (implies 

REQUEST 7 -track tape) 

ASSIGN 800 -bpi tape density (implies 

REQUEST 7 -track tape) 

LISTLB Specifies the file on which the 
labels are to be listed. 



LB= 



LO 
LO= 



ltype 



KL for LABEL state - 
ment. KL for ASSIGN 
statement if VSN key- 
word is included; 
otherwise, default is 
KU. KL for RE- 
QUEST statement if 
VSN keyword is. in- 
cluded or VSN control 
statement has been 
processed; otherwise, 
default is KU. 



Installation 
parameter 

R 



ASSIGN Specifies whether the tape is 

LABEL to be treated as labeled or un- 
REQUEST labeled. 

KU NOS unlabeled. 

KL NOS labeled. The tape 
is treated as having 
ANSI labels. If the tape 
is a NOS tape, volume 
and header accessibility 
restrictions will be 
enforced. 

NS Nonstandard labels. 

The system skips over 
labels based on tape 
marks but does not 
process the labels. 
This option can also be 
used in processing a 
non-NOS tape that, 
although designated as 
unlabeled, contains a 
tape mark prior to the 
beginning of data. 

ASSIGN 200 -bpi tape density (implies 

REQUEST 7 -track tape) 

LISTLB Specifies the type of labels to 
be listed (refer to appendix G). 

A List all required and 

optional ANSI labels. 
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Keyword Parameter 



Default 



Valid On 



Description 



R List all required labels 

(VOL1, HDR1, EOF1, 
and if present, EOV1) 

O List all optional labels 

(VOL2-9, HDR2-9, 
EOF2-9, EOV2-9, 
UVL1-9, UHLa, and 
UTLa) 

V List all VOL1 -9 labels. 

H List all HDR 1.-9 labels. 

F List all EOF1-9 labels. 

E List all EOV1-9 labels. 

U List all UVL1 -9, UHLa, 

and UTLa labels. 



LSL= 



lsl 



MT 



NT 



NS= 



ns 



The labels and data 
format of the specified 
volume require the 
agreement of the inter- 
change parties. 



Installation 
parameter 



Installation 
parameter 



BLANK Label standard level (refer to 
appendix G, VOL1 label). 

1 The labels and data for- 

mat of this volume con- 
form to the requirements 
of the ANSI standard. 

blank LSL omitted indicates 

that the labels and data 
format of the specified 
volume require the 
agreement of the inter- 
change parties. 

Specified file resides on or is 
to reside on 7 -track tape f 



For all data formats 
except I, SI, and X, 
the default for ns is 
18 frames. The NS 
keyword should not be 
specified for I, SI, and 
X format tapes because 
the definition of noise 
block size is implied 
by the format. (Refer 
to the F keyword. ) 



ASSIGN 
BLANK 
LABEL 
REQUEST 

ASSIGN 
BLANK 
LABEL 
REQUEST 

ASSIGN 
LABEL 
REQUEST 



Specified file resides on or is 
to reside on 9 -track tape f 



Noise size. Any block con- 
taining fewer than ns frames is 
considered noise and discarded 
by the system; the maximum 
value of ns is 31 frames. If a 
noise size of zero is specified, 
the default noise size is used. 



t If MT or NT is used and disagrees with the track type implied by the density selected, 
MT/NT CONFLICT message will be issued. 



the 
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Keyword Parameter 



Default 



Valid On 



Description 



OFA = 



fa 



Unlimited access 



BLANK 



OWNER = 



PE 



usernum/ Refer to 
familyname appendix G. 



PO= 



P1P2« 



Installation 
parameter 

p n U for system origin 
jobs 



BLANK 



ASSIGN 
REQUEST 

ASSIGN 
LABEL 
REQUEST 



One character that indicates the 
current file accessibility of a 
labeled tape which is to be 
blank labeled. (Refer to FA 
description for explanation of 
fa characters. ) 

Identifies the owner of the NOS 
labeled tape (refer to appendix 
B, VOL1 label). 

1600-cpi tape density (implies 
9-track tape) 

A string of characters spec- 
ifying processing options: 

A Job will be automatically 

aborted on an irrecover- 
able read or write parity 
error regardless of ep 
bit. 

N Job will not be aborted 

if an irrecoverable read 
or write parity error 
occurs regardless of 
ep bit; on a read opera- 
tion, data will be passed 
to the program. 

R Enforce ring out. If the 

tape is mounted with the 
write ring in, job proc- 
essing will be suspended 
until the operator re- 
mounts the tape cor- 
rectly. 

W Enforce ring in. If the 
tape is mounted without 
the write ring in, job 
processing will be sus- 
pended until the operator 
remounts the tape cor- 
rectly. 

U Inhibit unload. Do not 

unload at the end of 
usage. For system 
origin jobs, the inhibit 
unload option is selected 
by default; for all other 
origin type jobs, omis- 
sion of the U option 
causes the tape to be 
unloaded at end of usage. 
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Keyword Parameter 



Default 



Valid On 



B 



Description 

Force unload. Unload 
at the end of usage. 
This option is useful 
for system origin jobs 
where otherwise U (in- 
hibit unload) would be 
the default. 

Error inhibit. All hard- 
ware read /write errors 
are ignored and proces- 
sing continues. The 
system does not attempt 
error recovery, issue 
error messages, nor 
return error status. 
This option is not in- 
tended for the normal 
user. However, it can 
be used to recover por- 
tions of data from a bad 
tape, for hardware 
checkout purposes, and 
to write on tape without 
skipping bad spots; in 
the latter case, the user 
is responsible for veri- 
fying that the data was 
written correctly. 

Directs the system to 
write system noise 
blocks when performing 
write error recovery. 
This option is ignored 
for 1600 -bpi tapes. In 
addition, this option 
should not be used for 
tapes which are to be 
interchanged with other 
systems. 

Directs the system to 
ignore the block being 
read when the EOT is 
encountered, f 

Directs the system to 
accept the block being 
read when the EOT is 
encountered. | 



t For further information, refer to End-Of-Tape/End-Of-Reel Conditions at the end of this 
section. 
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Keyword Parameter 



Default 



Valid On 



Description 



QN= 

I P= 

R 



seqno 



Refer to appendix G. 



R 



LABEL 
LISTLB 



LABEL 



RT= 



SI= 

I M= 

SN= 
or 
V = 

T= 



rd 



set id 



Current date 



Refer to appendix G. 



secno Refer to appendix G. 

retcycle Refer to appendix G. 



LABEL 



LABEL 
LISTLB 



LABEL 



LABEL 



S Specifies where the 

system is to stop on an 
exit condition. For un- 
labeled tape, it directs 
the system to stop at 
the first tape mark after 
the EOT is sensed. For 
labeled tape, it directs 
the system to stop at 
the tape mark plus EOF1 
or the tape mark plus 
EOV1 when the EOT is 
encountered. 

1- to 4 -digit file sequence 
number (refer to appendix G, 
HDR1 label), t 

Directs the system to read the 
existing ANSI label. The 
parameters on the LABEL 
statement are compared with 
the values recorded on the file 
labels. If the comparison 
fails, the job is aborted. 

Retention date in the form 
yyddd (used to derive expira- 
tion date described in appendix 
G, HDR1 label). 

1- to 6 -character set identifier 
for a multifile set (refer to 
appendix G, HDR1 label). | 

1- to 4 -digit file section num- 
ber (refer to appendix G, HDR1 
label). 

1- to 3 -digit retention cycle 
specifying the number of days 
from the current data that the 
file is to be retained (used to 
derive the expiration date 
described in appendix G, HDR1 
label, if the RT keyword is not 
specified). 



| Refer to LABEL Statement in this section for constraints on using the QN and SI param- 
eters. 
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Keyword Parameter 



Default 



Valid On 



Description 



U 



Inhibit physical unload BLANK 
of tape at end of usage. 



VA= 



va 



Unlimited access 



BLANK 



W 



R 



VSN= 



vsn 



Refer to appendix G. 



Clears inhibit unload (PO=U) 
processing option; thus, tape 
is physically unloaded when 
returned after blank labeling. 

This does not apply to system 
origin jobs. 

Volume accessibility. One 
character that indicates re- 
strictions on who may have ac- 
cess to information on the reel 
(refer to appendix G, VOL1 
label). 

omitted VA omitted indicates 

unlimited access. 

other Whenever this reel is 
processed under NOS 
as an NOS labeled tape 
(LB=KL), volume ac- 
cessibility restrictions 
are imposed. Thus, 
the user cannot change 
or destroy the VOL1 
label on the tape. This 
feature enables an in- 
stallation to blank label 
new tapes and be assured 
that the volume serial 
number field of VOL1 
cannot be changed by a 
user. If VA is nonblank, 
only a system origin job 
can change VOL1. 

LABEL Directs the system to write 

standard ANSI labels using the 
parameters specified on the 
LABEL statement or their de- 
fault values. It is not necessary 
to specify the PO=W option to 
enforce ring in. If the tape is 
mounted without the write ring, 
job processing is suspended until 
the operator remounts the tape 
correctly. However, if the 
PO=R option is specified, the 
job is aborted. 

ASSIGN A 1- to 6 -character volume 

BLANK serial number that uniquely 

LABEL identifies a reel of tape (refer to 

REQUEST the VSN control statement). 
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The system allows continuation lines for ASSIGN, BLANK, LABEL, REQUEST, and VSN 
statements that require more than 80 characters. If, in processing one of these statements, 
the system does not encounter a termination character prior to the end of the line, it 
assumes the next line is a continuation line. All continuation lines must contain a blank 
in column 1. 



NOTE 



The system accepts continuation lines from a 
time-sharing terminal only if they are contained 
in procedure files. 

The programmer can use a literal for any parameter on a tape management control 
statement that contains nonalphanumeric characters. Characters other than letters, numbers, 
and asterisks are defined as nonalphanumeric. A literal is a character string delimited 
by dollar signs. Blanks within literals are retained. If the literal is to contain a 
dollar sign, two consecutive dollar signs must be included. Thus, the literal 

$A B$$41$ 

is interpreted as: 

A B$41 

If continuation cards are used, a literal cannot extend from one card to another. 

Generally, if more than one parameter of a given type is specified, the last one en- 
countered in a left-to-right scan is used. The two exceptions to this rule are in the 
processing option parameters. If both ring enforcement options (PO=R and PO=W) or 
more than one EOT option (PO=I, PO=P, POS) is specified, the ARGUMENT ERROR 
message is issued to the user's dayfile. 
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ASSIGN STATEMENT 

The ASSIGN control statement can be used to create a new unlabeled tape or access an 
existing labeled or unlabeled tape. The following description applies only to magnetic 
tape devices; for use of the ASSIGN statement with devices other than magnetic tape, 
refer to section 7. 

The control statement format is: 

ASSIGN(nn,lfn, D=den, 1^1^ oun't } , CV=conv, J ^ J , PO Pl p 2 . . . p n , 
F=format, NS=ns, LB=1, VSN=vsn, J £g 1 ) 

nn Device or device type to which the specified file is to be assigned; 

nn may be either the EST ordinal | of a magnetic tape unit or one 
of the device types MT or NT. MT is defined as a 7-track mag- 
netic tape drive; NT is a 9 -track magnetic tape drive. 

lfn Name of the file to be assigned to the specified equipment. 

Although the user can also include this statement to assign a labeled tape to his job, he 
cannot use it to create or verify tape labels. It is suggested that the user include 
LABEL statements for all tapes whenever possible. 

The job must be of system origin or the user must be validated for system origin 
privileges. The user must also be validated for use of magnetic tapes, tt If the user 
attempts to perform an assignment for which he is not validated, the job is aborted 
and the following message is issued to the user's dayfile. 

ILLEGAL USER ACCESS. 

Before performing the assignment, the system issues a RETURN on lfn. 
Example: 

ASSIGN( 51, TAPED 

This statement assigns the file TAPE1 to the magnetic tape unit identified by EST ordinal 
ox. 



t Contact installation personnel for a list of EST ordinals 
tt Refer to LIMITS control statement, section 6. 
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BLANK STATEMENT 



The control statement format is: 



BLANK(D=den, { ^Jf },CV=conv, VSN=vsn, FA=fa, OFA=ofa, VA=va, OWNER =usermim/ 



familyname, LSL=lsl, U) 



With the BLANK control statement, an installation can establish control over the use of 
labeled tapes. The values supplied on the statement are used to blank label a tape with 
standard ANSI volume header (VOL1), first file header (HDR1), and first end-of-file 
(EOF1) labels. The labels are written as follows: 





VOL1 


HDR1 


* 


J; 


EOF1 


* 


>!<: 







In writing these labels, the system uses default values for all fields except those fields 
for which there are corresponding parameters on the BLANK statement. The VA and 
FA keywords can be used to restrict access to information on the reel and the specified 
file, respectively. If the tape to be blank labeled is a labeled tape which has a file 
accessibility other than A, this old file accessibility must be specified by the OFA 
parameter. When the tape is blank labeled, the file accessibility is that specified by 
the FA parameter. The default track type may be set by the installation to either MT 
or NT. t If a- track type other than the default is desired, it must be specified. 

Once a tape has been blank labeled, the user can modify the labels as follows: 

1. If the volume accessibility field of VOL1 indicates unlimited access (that is, 
VA is blank), the user can: 

• Include another BLANK statement to change VOL1, HDR1, or EOF1 values. 

• Request the tape as unlabeled (that is, LB=KU) and write it in whatever 
format the user specifies. 

• Include a LABEL statement to change HDR1 by specifying one or more of the 
parameters associated with that label and selecting the write label (W) 
option. 

2. If the volume accessibility field is nonblanki the user can: 

• Include a LABEL statement to change HDR1. However, in requesting a tape 
in which VA is nonblank, the user must specify an NOS labeled tape 
(that is, LB=KL), and therefore, cannot change or destroy the VOL1 
label. 

• Submit a system origin job to change VOL1. 



t Contact installation personnel for the default track type. 
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LABEL STATEMENT 

The control statement format is: 

LABELdfn, D=den, FC=fcount, CV=conv, { nt! * PO= PlP2- • • Pn* F=format, NS=ns, 

SI=setidl /SN=secno 
M=setidj 



L B^,VSN=vsn. {CK|,jFI : meLdJ )FA=faj 



V=secno 



lfn Name of the file that resides on or is to reside on magnetic 

tape 

The LABEL control statement directs the system to assign file lfn to a tape unit. This 
assignment occurs using VSN only; the file identifier is not considered in assigning. 
If a file by the name lfn already exists, the following action is taken. 

1. If lfn is assigned to a device other than a tape unit, job processing continues 
with the next control statement. 

2. If lfn is an existing tape file and the read label (R) parameter is specified, the 
system compares the parameters on the LABEL statement with the values re- 
corded on the file labels. If the comparison fails, the job is aborted. 

3. If lfn is an existing tape file and the write label (W) parameter is specified, the 
system rewrites the header labels (information in HDR1 is not altered). Process- 
ing then continues with the next control statement. 

To assign to tape an lfn that was previously assigned in the same job to another device, 
the user must make sure that lfn is returned before the LABEL statement is processed. 
Note that the default track type may be set by the installation to either MT or NT. f If a 
track type other than the default is desired, it must be specified. If neither MT nor NT is 
specified and no VSNs are present, any equipment for which the user is validated may be 
assigned. 

If lfn is to be used for checkpoint dumps and the dumps are to be written on labeled tape, 
the CK or CB parameter must be included on the LABEL statement. For further information 
about checkpoint dumps, refer to the REQUEST control statement. 

The SI (M) parameter must be present for multifile label positioning using control I 

statements. If the QN (P) parameter is present, the multifile set is positioned to the \ 

file set member that matches the specific sequence number. If QN is not specified and 
the FI (L) parameter is present, the- multifile set is positioned to the file set member 
that matches the file identifier specified. If QN and FI are specified, a match must 
occur on both sequence number and file identifier. If neither QN nor FI is specified, 
the tape is positioned to the next file in the multifile set. 

To extend a multifile set, QN must be set to 9999. 

If the SI parameter is not specified, file positioning is not done. The R and W param- 
eters on the LABEL statement are ignored if SI is specified. If the W parameter is 
specified, (QN = 1) and it is the first OPEN on the file, an OPEN /WRITE is performed. 



| Contact installation personnel for the default track type. 
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Example 1 : 

LABEL (NEWFILE,VSN=TP01,FI=FILEA,W) 

This statement creates an ANSI-labeled tape which the job can access by the filename NEWFILE. 
Default values are used for all fields of HDR1 except the file identification, FILEA. 
Any data written is recorded in 512 CM word blocks. 

Example 2: 

LABEL(OLDFILE, VSN=TP0 1, FI=FILEA) 

This statement assigns the tape file created in a previous job (refer to example 1) to the file 
OLDFILE. The system compares the vsn in VOL1 and the file identification in HDR1 with 
the values on the statement. 

Example 3 : 

The following sequence of control statements in a single job creates two files of a 
multifile set. 

LABEL(TAPE, VSN=ONE, F=I, FI= FIRSTFILE, SI=TEST, QN=1, W) 

COPYBR (INPUT, TAPE) 

LABEL(TAPE, VSN=ONE, F= I, FI=SECONDFILE, SI= TEST, QN = 9999) 

COPYBR (INPUT, TAPE, 10) 

RETURN(TAPE) 

The sequence number QN must equal 9999 to add the second file. This file will be 
referenced with QN=2 (refer to examples 6, 7, and 8). 

Example 4: 

The following control statements in a new job add a third file to the multifile set 
created in example 3. 

LABEL(TAPE, VSN=ONE, F=I, FI=THIRDFILE, SI=TEST, QN=9999) 

COPYBR(DISK, TAPE, 3) 

RETURN(TAPE) 

Example 5: 

Any one of the following control statements can be used to read the first file of the 
multifile set created in examples 3 and 4. 

LABEL(TAPE, VSN=ONE, F=I) 
LABEL(TAPE, VSN=ONE, F=I, FI=FIRSTFILE) 
LABEL(TAPE, VSN=ONE, F'=I, FI=FIRSTFILE, SI=TEST) 

Positions according to the FI specification. The user will employ this method if 
the sequential location of the file on the tape is not known. 

LABEL(TAPE, VSN=ONE, F=I, QN=1, SI=TEST) 

Positions according to sequence number. 

LABEL(TAPE, VSN=ONE, F=I, QN=1, FI=FIRSTFILE, SI=TEST) 

Positions by sequence number, but there must be a satisfactory compare of the FI 
or the job will abort. 
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Example 6: 

Any one of the following control statements can be used to read the second file of the multi- 
file set previously created. 

LABEUTAPE, VSN=ONE, F=I,QN=2, SI=TEST) 
LABEL(TAPE, VSN=ONE, F=I, FI=SECONDFILE, SI=TEST) 
LABEL(TAPE, VSN=ONE, F=I, FI=SECONDFILE, QN=2, SI=TEST) 

Example 7 : 

Execution of the following control statements destroys the third file of the multifile set 
previously created. 

LABEUTAPE, VSN=ONE, F=I, QN=2, SI=TEST) 

Positions to the beginning of file 2. 
COPYBR (DISK, TAPE) 

Writes a new file 2. 
REWIND (TAPE) 

Puts an EOI at the end of file 2. 

Example 8: 

The following example can be used to replace the second file of the multifile set pre- 
viously created and still retain the first and third files. 

LABEUTAPE, VSN=ONE, F=I, QN=3, SI=TEST) 

COPYBR (TAPE, DISK, 3) Saves file 3 

LABEL(TAPE, VSN=ONE, F=I, QN=2, SI=TEST) 

COPYBR(INPUT, TAPE) Replaces file 2 

LABEL(TAPE, VSN=ONE, F=I, QN = 9999, SI=TEST, FI=THIRDFILE ) 

REWIND(DISK) 

COPYBR(DISK, TAPE, 3) Copies back file 3 

etc. 
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LISTLB STATEMENT 

The control statement format is: 

LISTLB Ufn, [%£"] . | Q ~) . LOXtype, L=out> 

The LISTLB control statement directs the system to read the ANSI labels on the tape 
file specified by lfn and write them on the user specified file out. The ltype param- 
eter allows the user to specify the type of labels to be listed (refer to appendix G for 
a description of each type of label). The setid and seqno parameters are used to list 
the labels of multifile tapes, as follows: 

setid seqno Significance 



Specified Not specified List labels of all files in multifile set. 

Specified Specified List labels of file with specified seqno only. 

Not specified Specified Illegal combination; LISTLB aborts. 

The user cannot position a multifile tape to a particular file and list the labels for that file. 
The multifile tape should be positioned at loadpoint, and LISTLB then positions the tape and 
lists the labels of the desired file. For example, the following lists the labels of file 2 of 
multifile set ABCDEF. 

LABEL(T, MT, D=HY, SI=ABCDEF, VSN=EXAMP1) 
LISTLB(T, SI=ABCDEF, QN=2) 

When listing the labels of all files of a multifile set, LISTLB keeps positioning the tape and 
listing the labels of each file until an end-of-set status is returned to the FET. This causes 
the following dayfile messages to appear in the user's dayfile 

MULTI-FILE NOT FOUND, lfn AT 110. 
REQUESTED SECTION n+1. 
FOUND SECTION n. 

where n is the last file of the set. These messages also appear if the user requested a file 
that was not in the set. 

To list all the labels of a multireel file, no special parameters or techniques are used. 
However, to list only the volume and/or header group labels (trailer labels not listed), the 
user requests each reel separately and employs a LISTLB control statement for each reel. 
This is necessary since, in this case, no SKIPEI is issued to cause automatic reel switching 
to take place. Automatic reel switching takes place only if trailer labels are also being 
listed. For example, the following lists both volume and header group labels of two reels 
of a multireel file. 

LABEL(T, MT, D=HY, VSN=REEL1) 

LISTLB(T, LO=VH) 

RETURN(T) 

LABEL(T, MT, D=HY, VSN=REEL2) 

LISTLB(T, LO=VH) 
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To list all the labels of a multireel file, only one LISTLB control statement is required. 
For example: 

VSN(T =REEL1 /REEL2) 
LABEL(T,MT,D=HY,VSN=REEL1) 
LISTLB(T) or LISTLB(T, LO=R) 

REQUEST STATEMENT 

The- REQUEST control statement enables the user to assign a file to a device by including 
in the comment field a description of an acceptable device. 

The control statement format is: 

REQUEST (lfn, D=den, J ^fj^jft j ' cv=conv > { NT } ' PO= Pl' ^ ' • V F=format ' 
NS=ns, LB=j£ , VSN=vsn, 1^1 ) 

This comment is displayed at the system console, directing the operator to make the 
requested assignment. If the user has previously specified a vsn via a VSN control 
statement or if he has included the VSN keyword on the REQUEST statement, the system 
initiates automatic tape file assignment. 

If lfn already exists when the REQUEST is made, no new assignment is made and job 
processing continues with the next control statement. However, the user can reassign lfn 
by issuing a RETURN on the file before making the REQUEST. 

The REQUEST statement can be used to create new and access existing 7- or 9-track 
unlabeled tapes. Although the user can also include this statement to assign a labeled 
tape to his job, he cannot use it to create or verify tape labels. It is suggested that 
LABEL statements be used for all tapes whenever possible. The default track type may 
be set by installation to either MT or NT. t If a track type other than the default is 
desired, it must be specified. 

If lfn is to be used for checkpoint dumps, either the CK or CB keyword is specified. 
These keywords are used in conjunction with the CKP and RESTART control statements; 
they allow the user to: 

e Save all checkpoint dumps by appending each dump to the checkpoint file 
REQUEST(lfn, CK) 



t Contact installation personnel for the default track type, 
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• Save the last checkpoint dump by writing each dump at the beginning of the 
checkpoint file. 

REQUEST (If n,CB) 

• Save two consecutive checkpoint dumps by alternately writing on two checkpoint 
files. 

REQUESTUfni, CB) 
REQUEST(lfn 2 , CB) 

If the CK parameter is specified for alternate files or if more than two checkpoint files 
are specified, the job is aborted and the following message is issued to the user's day- 
file. 

CHECKPOINT FILE ERROR. 

The user is not required to supply a REQUEST statement to define a checkpoint file. He 
can use an ASSIGN or LABEL statement or he can use default values. 

If no REQUEST statement specifying a checkpoint file has been detected when the first CKP 
statement is encountered, the system requests a device for the user, specifies a file name 
of CCCCCCC, and selects the CK option. For a subsequent restart job, however, the sys- 
tem assumes the user has made the checkpoint file available. 

VSN STATEMENT 

The control statement format is: 

VSNO-fn^vsn-plfno^sng, . . . ,lfn n =vsn ) 

lfn. Name of the file with which the specified vsn is to be 

associated 

vsnj 1- to 6 -character volume serial number to be associated 

with lfni. If the vsn^ is zero, absent, or SCRATCH, any 
available scratch tape is automatically assigned to lfn[. If 
characters other than letters and numbers are used, vsn^ 
must be specified as a literal. 

The system allows tape assignment to be performed either by the system or by the 
operator. By supplying a vsn uniquely identifying every tape (labeled, unlabeled, and 
nonstandard labeled), the user enables the system to assign tapes without operator 
intervention. 

A vsn is provided via the VSN keyword on a LABEL or REQUEST statement or via a 
VSN statement. With a VSN statement the user can: 

• Omit the VSN keyword from his LABEL or REQUEST statements and specify 
lfn /vsn associations on the VSN statement instead. This allows the user to 
specify new vsns without changing LABEL or REQUEST statements. 
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• Override the vsn specified on subsequent ASSIGN, LABEL, REQUEST, or 
VSN statements. For example, the sequence. 

VSN(FILEA = 123) 

VSN(FILEA = 124) 

LABEL(FILEA) 

directs the system to assign FILEA to the tape with vsn 123. However, 
the user can redeclare an lfn/vsn association by returning the file. Thus, 
the following sequence 

VSN(FILEA = 123) 

RETURN(FILEA) 

VSN(FILEA = 124) 

LABEL(FILEA) 

directs the system to assign to FILEA the tape with vsn 124. 

• Associate the vsns of two or more duplicate reels with one file.t If any 
of several duplicate reels can be used (that is, they differ only in vsns), 
the vsns should be separated by equal signs. Thus, the statement 

VSN(FILE1=VOL100=VOL101) 

indicates that either the tape with the vsn of VOL 100 or the tape with the 
vsn of VOL101 can be assigned to FILE1. 

• Specify the vsns of a multireel file.t If the file extends to more than one 
reel, the vsns for all reels required must be separated by slashes. 

The system assigns the reels in the order indicated in the statement. 
For example, the statement 

VSN(FILE2=VSN23/VSN24/VSN25) 

indicates that FILE2 may extend to the three reels identified by the vsns of 
VSN23, VSN24, and VSN25. 

The system processes tape requests as follows: 

1. Whenever a tape is mounted, the system checks for labels. If the tape was 
labeled, the system keeps a record of the vsn read from VOL1 and the equip- 
ment on which the tape is mounted. 

2. If, when a request is made for tape assignment, an lfn/vsn association is en- 
countered, the system compares the vsn associated with the file (or one of its 
equivalences) with the vsns read from mounted tapes. If a match is found, the 
system automatically assigns the tape to the requesting job, provided a deadlock 
would not occur. If the tape is not mounted, the system rolls out the job until 

a tape with the required vsn is mounted. For a mounted, unlabeled tape, the 
operator enters a VSN command specifying the required vsn. The system is 
then able to automatically assign the tape. 

3. If no lfn/vsn association is encountered when the request is made, the system 
directs the operator to assign an available unit. 

4. For an ASSIGN statement, the method of assignment depends on the nn 
parameter. If nn is a device type (MT or NT), the operator must assign 
an available unit. If nn is the EST ordinal of a tape unit, the system 
automatically assigns the specified unit. 



t Up to 55 vsns can be specified for a single file in any combination of duplicate reel 
and /or multireel configurations. 
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The following is a summary of the system and /or operator action taken in response 
to an ASSIGN, LABEL, or REQUEST statement. The VSN column indicates whether 
or not the user has specified an lfn/vsn association via the VSN keyword or a VSN 
statement. The mode column shows the mode as determined by the system in check- 
ing for labels. 



Statem ent 
ASSIGN 



LABEL 



VSN 
Yes 



Yes 



No 



No 



REQUEST Yes 



Mode 
Labeled 



Unlabeled 



Labeled 



Unlabeled 



Labeled 



Yes 


Unlabeled 


No 


Labeled 


No 


Unlabeled 


Yes 


Labeled 


Yes 


Unlabeled 


No 


Labeled 


No 


Unlabeled 



Action 

If the nn parameter is MT or NT, the operator 
must assign an available unit. If the nn param- 
eter is the EST ordinal of a tape unit, assign- 
ment is automatic. 

Same as when the vsn is specified and the tape 
is labeled. 

Same as when the vsn is specified and the tape 
is labeled. 

Same as when the vsn is specified and the tape 
is labeled. 

The system matches the vsn read from VOL1 
with the vsn on the REQUEST or VSN state- 
ment. Assignment is automatic. 

The operator enters a VSN command specifying 
the vsn included on the REQUEST or VSN state- 
ment, t Assignment is automatic. 

The operator assigns an available unit to lfn. 

The operator assigns an available unit to lfn. 

The system matches the vsn read from VOL1 
with the vsn on the LABEL or VSN statement. 
Assignment is automatic. 

The operator enters a VSN command specifying 
the vsn included on the LABEL or VSN state- 
ment.! Assignment is automatic. 

The operator assigns an available unit to lfn. 

The operator assigns an available unit to lfn. 



The LB keyword is not used in assigning a tape, 
on the tape once the assignment has been made. 



Rather, it is used in processing the data 



t A VSN which contains special characters should not be specified in a request for an unlabeled 
tape. It is not possible to enter special characters via the VSN, xx, aaaaaa. operator com- 
mand. 
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MAGNETIC TAPE FORMATS 

The standard magnetic tapes used are 7 -track, 1/2-inch tape and 9 -track, 1/2 -inch 
tape. Each type of tape can be written in binary or coded mode. Unless specified 
otherwise, tapes are assumed to be in binary mode. The user can select 200, 556, 
or 800 bits per inch (bpi) density for 7-track tapes or 8,00 or 1600 characters per 
inch (cpi) density for 9-track tapes, provided these densities are available with the 
hardware. Tape density can be specified by a LABEL, ASSIGN, or REQUEST control 
statement, the LABEL macro (refer to section 4, volume 2), or an IPRDECK installa- 
tion option (refer to the NOS Installation Handbook). The system normally performs 
automatic processing of tape parity errors and end-of-tape conditions. However, the 
user can control the processing of these functions via the PO keyword on LABEL, AS- 
SIGN, and REQUEST control statements or the up and ep fields of the FET (FET+1, 
bits 45 and 44). 

DATA FORMATS 

Data can be recorded on magnetic tape in any of eight formats. 



Format 


Description 


I 


Internal 


SI 


System internal -j- 


X 


External 


S 


Stranger 


L 


Long block stranger 


E 


Line image 


B 


Blocked 


F 


Foreign 



The control statement user specifies the data format via the F keyword of a LABEL, 
ASSIGN, or REQUEST control statement. The LABEL macro user specifies the data 
format via FET+10, bits 30 through 35. The following is a description of the physical 
and logical characteristics of each format. Note that the user can define maximum 
block size, end-of-reel conditions, and noise for any format via control statement or 
FET parameters; the following description of these characteristics defines the suggested 
(and default) values. 



| NOS /BE system default tape format. 
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I (Internal) Format 

Characteristics 
Header 

Mode 

Block size (PRU size) 



Logical end-of-record 



Logical end-of-file 



Logical end-of-information 



Description 
Labeled or unlabeled 

Binary 

Actual data block size can range from to 512 
(lOOOo) CM words in exact multiples of CM words. 
All blocks except those containing labels include 
a 48-bit block terminator formatted as follows: 



47 



35 



11 



3 



byte count 


block number 





In 



byte count 

block number 
In 



Total number of bytes in the 
block including the block 
terminator 

Number of blocks since the 
last HDR1 labelt 

Level number 

End-of-record 

17 End-of-file 



User-specified frame or character counts have no 
meaning. 

Any block with fewer than 512 (lOOOg) CM words 
of data is considered a logical end-of-record. 
During a write operation, the level number field of 
the block terminator contains the level number 
obtained from FET+0, bits 14 through 17, or the 
WRITECW macro control word. During read op- 
erations, the system will return end-of-record 
status and the contents of the block terminator level 
number field. If the level number is 17g, the 
system will also return end-of-file status. Some 
blocks may consist only of a block terminator. 

Any block consisting of only a block terminator with 
a level number of 17g is considered a logical end- 
of-file. The system ensures that an end-of-record 
will always precede an end-of-file by writing, if 
necessary, a block terminator with a level number 
of zero prior to the end of file. 

A tape mark followed by an EOF1 label is con- 
sidered the end-of-information. This trailer se- 
quence is generated by the system on labeled and 
unlabeled I and SI format tapes. The system is- 
sues a label content error if it encounters a tape 
mark without a valid label following it. 



t Refer to appendix G. 
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Characteristics 
End-of-reel 



Noise 



Special considerations 



Description 

Refer to option 3 under End-Of-Tape/End-Of-Reel 
Conditions. 

Any block containing fewer than eight frames for 
7-track tapes or six frames for 9-track tapes is 
considered noise, and therefore, ignored. 

9 All 9-track tapes are written in an even multiple of 
bytes. 

• On all read operations, the system checks for fill 
status and compares the number of bytes read and 
the block number expected with the byte count and 
block number values in the block terminator. If 
the specified condition does not occur, the system 
handles it as if it were a parity error. This method 
is designed to prevent dropped or fragmented blocks; 
in general, it provides a much higher degree of 
reliability than any other format. 



SI (System Internal) Format 

Characteristics 

Header 

Mode 

Block size (PRU size) 



Description 

Labeled or unlabeled 

Binary or coded as indicated by FET+0, bit 1. 

For binary mode, the block size can range from 
to 512 (1000 8 ) CM words in exact multiples of CM 
words. Any block smaller than the maximum size 
except those containing labels will contain a 48-bit 
block terminator. This terminator has the same 
format as that for I format. For coded mode, the 
block size can range from to 128 (200n) CM words 
in exact multiples of CM words. Any block smaller 
than the maximum size except those containing labels 
will contain a 48-bit block terminator formatted as 
follows: 



47 







blanks 



in 



Logical end-of-record 



In Blank if level is 

1 through 17 g for all other levels 

User-specified frame or character counts have no 
meaning. 

For binary mode, any block containing fewer than 
512 (lOOOg) CM words represents a logical end-of- 
record. For coded mode, any block containing fewer 
than 128 CM words represents a logical end-of-record. 
If a logical record consists of an exact multiple of 
512 (binary) or 128 (coded) CM words, the block 
that denotes the logical end-of-record consists solely 
of a block terminator. During write operations, the 
level number field of the block terminator contains 
the level number from FET+0, bits 14 through 17, 
or the WRITECW macro control word. During read 
operations, the system will return end-of-record 
status and the contents of the block terminator level 
number field. If the level number is 17«, the system 
will return end-of-file status. 
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I 



Characteristics 



Description 



Logical end-of-file 
Logical end -of- information 
End-of-reel 

Noise 

Special considerations 



X (External) Format 

Characteristics 

Header 

Mode 

Block size (PRU size) 

Logical end-of-record 



Same as for I format. 

Same as for I format. 

Refer to option 3 under End-Of-Tape/End-Of-Reel 
Conditions. 

Same as for I format. 

• The system writes all 9 -track tapes with 3n+2 mode. 

• The system does not perform block checking via block 
terminators as is done for I format. 

• For read and write operations on a coded 7 -track tape, 
NOS is incompatible with NOS/BE. The system con- 
verts data from display code to external BCD on write 
operations and from external BCD to display code on 
read operations. NOS/BE converts data from external 
BCD to internal BCD on both read and write operations. 

• For 7 -track tapes, standard code conversion is 
performed. For 9-track tapes, no code conversion 
will be performed (it is written to tape in display 
code). 

• For read operations, if a coded 7-track tape contains 
external BCD 1632 in byte 4 of a CM word, the 
system converts it to an end-of-line (0000 in display 
code). The converse is true for write operations. 

• The FET device type is returned in NOS/BE format 
(refer to the description of the CIO OPEN macro in 
section 3, volume 2). 



Description 



Unlabeled 



Logical end-of-file 



Binary 

Actual data block size can range from to 512 (1000 8 ) 
CM words in exact multiples of CM words. 

Any block containing fewer than 512 CM words repre- 
sents a logical end-of-record. If a logical record 
consists of an exact multiple of 512 words, the block 
that denotes the logical end-of-record consists solely 
of a 48 -bit block terminator. 

Tape mark 
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Characteristics 

Logical end-of-information 

End-of-reel 

Noise 

Special considerations 



Description 



None 



Refer to option 1 under End-Of-Tape/End-Of-Reel 
Conditions. 

Same as for I format. 

• X-formatted tapes cannot be labeled. 

• All 9-track tapes are written in an even multiple of 
bytes. 



S (Stranger) Format 

• Characteristics 
Header 
Mode 
Block size (PRU size) 



Logical end-of-record 

Logical end-of-file 
Logical end-of-information 



End-of-reel 



Noise 



Special considerations 



Description 
Labeled or unlabeled 

Binary or coded as indicated by FET+0, bit 1. 

No explicit multiple of frames is required. The 
maximum block size may be specified in the .mlrs 
field of the FET (FET+6, bits through 17). If 
no block size is specified in the mlrs field, it is 
assumed to be lOOOg. The maximum block size 
is lOOOg CM words. If the block size is longer 
than lOOOg, the tape is L format. 

On a CIO READ (010) or READSKP(020) request, 
each PRU is considered an end of record. 

Tape mark 

If the tape is unlabeled, there is no logical end-of- 
information. If the tape is labeled, the logical end- 
of-information is a tape mark followed by an EOF1 
label. 

Refer to option 2 under End-Of-Tape/End-Of-Reel 
Conditions. 

Any block containing fewer than 18 frames is con- 
sidered noise, and therefore, ignored. 

• Level numbers 1 through 16s are interpreted as level 
number 0. 

• Standard code conversion is performed for 7- or 9- 
track tapes in coded mode. 

• For CIO READ (010), WRITE (014), WRITER (024), 
and WRITEF (034) functions, a one-block (PRU) 
operation is performed with the unused bit count 
(FET+7, bits 24 through 29) taken from and returned 
to the FET. 

© The FET device type is returned in NOS/BE for- 
mat (refer to the description of the CIO OPEN 
macro in section 3, volume 2). 



L (Long Block Stranger) Format 

The characteristics and descriptions are the same as for S format tapes except that if 
no block size is specified in the mlrs field (FET+7, bits through 17), it is assumed 
to be LIMIT - FIRST- 1. 
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E (Line Image) Format 

Characteristics 
| Header 

Mode 

Block size (PRU size) 



Logical end-of-record 

Logical end-of-file 
Logical end -of- information 

End-of-reel 

Noise 

Special considerations 



Description 
Unlabeled 

Coded 

The block size cannot exceed 5120 frames. If the 
tape unit will not allow an odd number of frames to 
be written, the system will append a space. Unless 
the user specifies otherwise when he requests the 
tape, the system assumes the maximum block size 
is 136 frames. 

For a write operation, there is no logical end-of- 
record. For a read operation, end-of-record status 
is returned when a tape mark is encountered. An 
additional read operation returns end-of-file status. 

Tape mark 
None 

Refer to option 2 under End-Of-Tape/End-Of-Reel 
Conditions. 

Same as for S-formatted tapes. 

E-formatted tapes cannot be labeled. 

For a write operation, a block of data will stop either 
at a zero byte (end-of-line) in byte 4 of a CM word or 
at the multiple of CM words (rounded up) based on the 
frame or character count. The system will then space- 
fill the buffer to the number of frames specified. Thus, 
the amount of data written will exactly equal the amount 
specified. 

For a read operation, if there is an odd number of 
characters, the system will space-fill the last six 
bits of the last byte and delete all trailing spaces. 
For control word reads, byte count and unused bit 
count will be set appropriately. For regular reads, 
EOL is guaranteed. 

For a control word write operation, no end-of-line 
processing is done. Data is blocked on tape using the 
specified frame count. Likewise for a control word 
read operation, no end-of-line processing is done; 
data is transferred to the user as it is read. 
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B (Blocked) Format 

Characteristics 

Header 

Mode 

Block size (PRU size) 



Description 



Logical end-of-record 

Logical end-of-file 
Logical end-of-information 
End-of-reel 

Noise 

Special considerations 



Unlabeled 

Coded 

The block size cannot exceed 5120 frames. If the 
tape unit will not allow an odd number of frames 
to be written, the system will append a space. Un- 
less the user specifies otherwise when he requests 
a tape, the system will assume the maximum block 
size is 150 frames. 

For a write operation, there is no logical end-of- 
record. For a read operation, end-of-record status 
is returned when a tape mark is encountered. An 
additional read operation returns end-of-file status. 

Tape mark 
None 

Refer to option 2 under End-Of-Tape/End-Of-Reel 
Conditions. 

Same as for S-formatted tapes. 

• B -formatted tapes cannot be labeled. 

• A write operation will stop either at a zero byte 
(end -of -line) in byte 4 of a CM word or at a mul- 
tiple of CM words (rounded up) based on the frame 
or character count. 

• For control word reads, byte count and unused bit 
count will be set appropriately. For regular reads, 
EOL is guaranteed. 

• For a control word write operation, no end-of-line 
processing is done. Data is blocked on tape using 
the specified frame count. Likewise for a control 
word read operation, no end-of-line processing is 
done; data is transferred to the user as it is read. 
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F (Foreign] Format 

Characteristics 

Label 
Mode 

Block size (PRU size) 



Logical end-of-record 
Logical end-of-file 
Logical end-of-information 
End of reel 

Noise 

Special considerations 



Description 

Unlabeled 

Binary or coded, as needed, for 7-track tapes and 
binary for 9 -track tapes 

The block size cannot exceed the CM buffer size. 
No explicit multiple of frames is required. The 
maximum block size must be specified at tape 
request time. The block size is used to determine 
whether to continue read or write operations based 
on the amount of data versus the space in the buffer, 
For example, if the maximum block size is IOOO3 
CM words, the read operation will stop any time 
less than lOOlg words remain. It is recommended 
that the user specify a buffer size equal to the 
largest block. 

None 

Tape mark 

None 

Refer to option 1 under End-Of-Tape/End-Of-Reel 
Conditions. 

Any block containing fewer than 18 frames is con- 
sidered noise, and therefore, ignored. 

For 7-track tapes, if a parity error is detected be- 
cause the tape is being read in the opposite mode, 
the mode will be switched. 

F-format operations are only done using control 
word reads and writes. On read operations, the 
control words are transferred to the user regard- 
less of the operation being used. 

Labeled tapes that have been assigned as F format 
will have their labels treated as data on 7-track 
tapes. Labels will generate parity error on 9- 
track tapes, which process binary mode only. 
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END-OF-TAPE/END-OF- REEL CONDITIONS 

The following is a description of the processing options for end-of-tape conditions. The 
user can select one of these options by default by specifying the data format or he can 
specify an option via the PO keyword on a LABEL, ASSIGN, or REQUEST control state- 
ment or the processing option field of the FET (FET+8, bits 36 through 47). In addi- 
tion, the user processing option (FET+1, bit 45) gives the macro user control over 
end-of-reel conditions. For further information, refer to the CLOSER, REWIND, and 
UNLOAD macros described in section 3, volume 2. 



Option PO= Option Description 

1 I If, during a write operation, the system senses the end- 

of-tape, it rewrites the block on which the EOT occurred 
as the first block on the following reel. No trailer infor- 
mation is written on the current reel. During a read 
operation, the block on which the EOT occurred is ignored 
and reading continues on the next reel. If a tape mark 
and the EOT are sensed at the same time, the EOT is 
ignored. 

2 P If, during a write operation, the system senses the end- 

of-tape, the system writes a trailer sequence, consisting 
of a tape mark, following the block on which the EOT was 
sensed. Any data that occurs following the block on which 
EOT was sensed, yet before the tape mark, is ignored. 
During a read operation, the system transfers to the user 
the block on which the EOT was sensed. The read opera- 
tion resumes on the next reel. If a tape mark and the 
EOT are sensed at the same time, the EOT is ignored. 

3 S If, during a write operation, the system senses the end- 

of-tape, the system writes a trailer sequence following the 
block on which the EOT was sensed. This trailer sequence 
consists of a tape mark followed by an EOV1 label for 
labeled tapes and tape marks for unlabeled tapes. The 
next block is written on the next reel. During a read 
operation, the EOT is noted and the system transfers to 
the user the block on which the EOT was sensed plus all 
following blocks until a trailer sequence (as described 
above) is recognized. Reading resumes on the next reel. 

For options 1 and 2, the system is concerned only with the block on which the EOT is sensed. 
If tapes written using these options are transferred to another system, any data that occurs 
on the reel after this block should be ignored. 
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PRODUCT SET CONTROL STATEMENTS 



11 



Table 1-11-1 gives a list of widely used products supported by NOS and the basic con- 
trol statement formats for these products. The parameters for the COMPASS control 
statement are described in volume 2 of this reference manual. The parameters for 
the. other control statements in the table are given in this section. For the full array 
of products supported by NOS, consult the list of publications in the preface. 

FORTRAN Extended 4, COBOL 4, COBOL 5, and Sort/Merge 4 use the CDC CYBER 
Record Manager for accessing files. NOS supports the indexed sequential, direct 
access, and actual key file capabilities of the Record Manager (refer to the CDC CYBER 
Record Manager Reference Manual). 

TABLE 1-11-1. PRINCIPAL PRODUCTS SUPPORTED BY NOS 





Basic 


Product Name 


Control Statement 




Format 


ALGOL 4 


ALGOL. 


BASIC 3 


BASIC. 


COBOL 4 


COBOL. 


COBOL 5 


COBOL5. 


COMPASS 3 


COMPASS. 


FORTRAN Extended 4 


FTN. 


Sort/Merge 4 


SORTMRG. 



USER LIBRARIES 

NOS offers the user the option of specifying a library other than the product set default 
library. The user can then write library routines to perform special functions to meet 
his own requirements. | Routines can also be given names identical to routines from 

another library without causing a system conflict. This enables a user to compare the 
performance of library routines without modifying his software. 



f Refer to the CDC CYBER Loader Reference Manual for information about the genera- 
tion of a user library. 
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The libraries from which externals are to be satisfied can be specified as parameters 
on the LDSET statement as follows: 

LDSET(LIB=lib 1 /lib 2 /. . . /.lib n ) 

LOAD(lfn) 

lib^ Library from which externals are to be satisfied. The system checks 

through the specified libraries sequentially. 

lfn Name of the file to be loaded. 

Libraries can also be specified by using the LIBRARY statement to define the global 
library set. t The default system library, SYSLIB, is used to satisfy the externals if no 
library is specified or if unsatisfied externals exist after using the libraries specified or 
defaulted. 



CONTROL STATEMENT FORMATS 

The following is a description of the program call statements for the product set mem- 
bers listed in table 1-11-1 (with the exception of COMPASS, which is given in volume 
2). 



NOTE 



Product set format does not allow file names be- 
ginning with a numeric character (refer to Control 
Statement Format, section 5). 



t Refer to the CDC CYBER Loader Reference Manual for information about the genera- 
tion of a user library. 
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ALGOL STATEMENT 



The ALGOL control statement is used to call the ALGOL 4 compiler to a control point. 
The minimum memory requirement for ALGOL 4 is 46, 000 octal locations. External 
references are satisfied from ALGOLIB. 

The control statement format is: 

ALGOL, pj, p 2 , ..., P n . 

The following parameters may be supplied. The absence of any parameter suppresses 
the corresponding option. 



£L 
A 

A=0 

A omitted 

B 

B=lfnx 

B=0 

B omitted 

C=n 



C omitted 

D 

D=lfn 2 



Description 

Specifies that the assembly language form of the object code is to be 
written on the file specified by the L option. 

No assembly language listing. 

Same as A=0. 

The output object program is to be written on file LGO. 

The output object program is to be written on file lfn^. 

No binary object program. 

Same as B=LGO. 

Comments interpretation for special delimiters. This option requires 
the compiler to search comments for special delimiters interpretation. 



Description 



No comments interpretation. 

Debugging directives which are present in comments 
are detected by the compiler and cause debugging 
code to be inserted into the object program. 

2 Overlay directives which are present in comments are 
detected by the compiler and cause overlay directives 
in loader input format to be inserted into the object 
program. 

3 Array bound checking directives which are present in 
comments are detected by the compiler. 

Multiple selection for the C option can be performed by separating 
each value by a slash. For example, C=3/2/l is acceptable. 

Same as C=0. 

The symbol file is created on file DUMPFIL. 

The symbol file is created on file lfr^. 
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Pi Description 

D=0 The symbol file is suppressed. 

D omitted Same as D=0. 

E The job is aborted if a fatal error occurs during compilation. If an 

EXIT control statement is included in the job, exit processing is 
performed. 

E=0 Suppresses abort in the event of a fatal error. 

E omitted Same as E=0. 

F If a fatal error is found in the first pass, compilation is terminated at 

the end of this pass. 

F=0 Continue until the normal end of compilation. 

F omitted Same as F=0. 

G Compilation will consider stack swapping to ECS and when the program 

is executed, the swapping procedures are activated automatically. 

G=0 No swapping will be considered. 

G omitted Same as G=0. 

This option must not be selected when using a machine without ECS; 
otherwise, unpredictable results leading to a fatal error are obtained. 

I Source input is on file INPUT. 

I=lfti3 Source input is on file lfn3. 

1=0 No source input. 

I omitted Same as I=INPUT. 

K=n Input record size. 

n The number of significant characters to be interpreted 

by the compiler on the source statement image. 

K omitted Same as K=72. 

L The source program is listed with fatal diagnostics on file OUTPUT. 

L=lfti4 The source program is listed with fatal diagnostics on file lfn^ 

L=0 Fatal diagnostics only are listed on file OUTPUT. 

L omitted Same as L=OUTPUT. 

N A listing of advisory diagnostics is generated on the file specified by 

the L option. 

N=0 Advisory diagnostics are suppressed; only diagnostics fatal to code 

generation are listed. 
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P[ Description 

N omitted Same as N. 

0=n Specifies the level of compiled optimization, 

n Description 



The program is compiled in fast compile mode. 

1 Linguistic optimization is performed by optimizing 
procedure calling. 

2 Optimizations of 0=1 and also subscript and for state- 
ment optimizations. 

O Same as O=0. 

O omitted Same as 0=0. 

P Specifies that the assembly language form of the object code is to be 

punched in standard assembly language card format on file PUNCH. 

P=lfn5 Assembly language is to be punched on file lfng. 

P=0 Assembly language punching is suppressed. 

P omitted Same as P=0. 

Q Creates interactive file on file QFILE for ALGOL Interactive Debugging 

Aids (AIDA). 

Q=lfns Creates interactive file on file lfng. 

Q=0 Suppresses interactive compilation and file. 

Q omitted Same as Q=0. 

Q may not be specified if the S option is selected. 

R A cross-reference map is produced and listed at compile time for 

identifiers in the source program on the file specified by the L option. 

R=0 No cross-reference map is produced. 

R omitted Same as R=0. 

S=n Array storage location. 

n Description 
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All arrays are allocated to CM. 

1 Virtual arrays are allocated to ECS. 

2 All arrays are allocated to LCM. This option applies 
only to programs executed on a CDC CYBER 70 Model 
76. 

S may not be specified if the Q parameter is specified. 
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Pi Description 

S omitted Same as S=0. 

U Specifies that the file COMPILE contains user implicit outer block 

head input, supplementary to the file specified with the I option. 

U=lfn7 The source program is preceded by the implicit outer block head list 

on file lfn^. 

U=0 There is no file for implicit outer blocks. 

U omitted Same as U=0. 

X Allows real -integer (or integer -real) correspondence between formal 

and actual parameters; if real-integer, perform the conversion. 

X=0 Forbids any real-integer (or integer -real) correspondence between 

formal and actual parameters. 

Selection of this option significantly degrades performance of the 
program. 

X omitted Same as X. 



BASIC STATEMENT 

The BASIC control statement is used to call the BASIC 3 compiler to a control point. 
The minimum memory requirement for BASIC 3 is 35000 octal locations. Ordinarily, 
a BASIC program is compiled in place. Since all object -time routines are contained 
within the compiler, no external references are generated. However, the user can 
include the B parameter to generate relocatable code. When this code is loaded, ex- 
ternals are satisfied from the library BASLIB. 

The control statement format is: 

BASIC, p]_, p 2 , . . . , p n . 
The following parameters may be supplied. 

Pi Description 

AS 



AS=0 



Source program is encoded in extended ASCII character set (program 
will run in ASCII mode). 

Source program and data files contain only normal (non -ASCII) char- 
acters. 



AS omitted Same as AS=0. 
B 



B=lfn 



B = 



Relocatable object code is written on file BIN (this option requires at 
least 4000g words of additional memory). 

Relocatable object code is written on file lfn (this option requires at 
least 4000g words of additional memory). 

Specifies compilation to memory; no relocatable object code is 
generated. 
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p« Description 

B omitted Same as B=0. 

BL Page eject between source, object, and execution output listing. This 

option is ignored if output is returned to a time -sharing terminal. 

BL omitted Page eject between source and object listing is suppressed; listing is 
not burstable. Unless the B parameter is omitted, page eject pre- 
ceding execution output is also suppressed. 

E Compiler error diagnostics are written on file ERRS. 

E=lfn Compiler error diagnostics are written on file lfn. 

E omitted Compiler error diagnostics are written on the file specified by the 
L parameter. If L=0, they are written on the file OUTPUT. 

EL=W Warning diagnostics and fatal compiler diagnostics are written on the 

file specified by the E parameter. 

EL=F Fatal compiler diagnostics are written on the file specified by E 

parameter; no warning diagnostics are included. 

EL omitted Same as EL=W. 

GO Executes compiled BASIC program (if B is specified, the relocatable 

binary is loaded and executed; if B is omitted, the compiled -to - 
memory code is executed). 

GO=0 Inhibits execution; neither compiled -to-memory nor relocatable binary 

code will execute. 

GO omitted Compiled -to -memory code is executed. Relocatable binary code (B 
specified) is not executed. 

I Source input is on file COMPILE. If I is omitted, input is on file 

INPUT. 

I=lfn Source input is on file lfn. 

I omitted Input will come from the file INPUT. 

J=lfn Run-time input is on file lfn. 

J=0 No run-time input file is used. If this option is specified, use of the 

INPUT statement aborts an executing BASIC program. 

J omitted Run-time input is on file INPUT. 

K Execution output is written on file OUTPUT. 

K=lfn Execution output is written on file lfn. 

K omitted Same as K. 

L Listable compiler output is written on file OUTPUT. 
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Pi Description 

L=lfn Listable compiler output is written on file lfn. 

L=0 No listable compiler output is generated. 

L omitted For batch origin jobs, this is the same as L. 

For time -sharing origin jobs, listable compiler output is suppressed. 

LO Source listing is written on file specified by the L parameter. 

LOS Source listing is written on file specified by the L parameter. 

LO=0 Object code and source listing is written on file specified by the L 

parameter. 

LO=0/O Object code listing is written on file specified by the L parameter. 

LO=0 Turns off all list options. 

LO omitted Same as LO. 

PD or Sets print density to 8 lines per inch for files specified by the K and 

PD=8 L parameters. The installation default print density is automatically 

reset after output is written. 

PD=6 Sets print density to 6 lines per inch for files specified by the K 

and L parameters. The installation default print density is automa- 
tically reset after output is written. 

PD omitted Sets print density for files specified by the K and L parameters to the 
installation default (usually 6). 

PS=n Specifies page size as n printable lines per page (4< n<; 32768). 

PS omitted If PD is also omitted or specifies a print density default, the installa- 
tion default page size will be used. 

If PD specified a nondefault print density, PS is calculated with the 
formula: 



PS=PD*(default -PS)/ (default PD) 



COBOL STATEMENT 



The COBOL control statement 'calls the COBOL 4 compiler to a control point. The 
minimum memory requirement for COBOL is 52000 octal locations. External refer- 
ences are satisfied from COBOL. 

The control statement format is: 

COBOL, p t , p 2 , . . • , P n . 

If the control statement does not fit on one card, it can be continued on the next card. 
However, the last character on the first card must be a separator, such as (, +- or /. 
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The following parameters can be supplied. 

p- t Description 



A Leading blanks are treated as zeros in arithmetic statements and 

comparisons. 

B Relocatable binary object code is written to file LGO. If the B 

parameter is omitted, this option is assumed. 

B=lfni Binary object code is written to file lfnj. The file name should 

specify a mass storage file. 

B=0 Suppresses binary output of object code. 

B omitted Relocatable binary file is writen on file LGO. 

BUF In COBOL 4, buffer sizes are based on the record description; a min- 

imum size of 514 words has been established. The BUF parameter 
selects the version 3 method which does not use record description 
or ALTERNATE AREAS to determine the minimum block size. 

C Specifies that a copy is to be made from source rather than from the 

library, which is the default condition. 

D Inhibits COBOL program execution when an E diagnostic is encountered. 

DB Checks for subscript range errors. If an error is encountered, the 

run is terminated. If DB is not specified, no check is made for 
subscript range errors. 

DBl Allows generation of object code which calls .paragraph trace feature 

to trace the flow of the COBOL program. 

E Allows output of a COBOL compilation to be added to the system 

library with EDITLIB. This parameter has no application for NOS. 

E=program- The main overlay of the program is named by program-name, which 
name must not exceed five characters. 

F All data name entries described as COMPUTATIONAL are interpreted 

as COMPUTATIONAL -1 when this parameter is included. 

H Increases sort efficiency if no OPEN statement is executed during 

SORT input or output procedure. If this parameter is not used, 
unnecessary space is reserved for all program files. If a file is 
opened during , input /output and H is specified, the run is terminated. 

I Specifies that compiler input is to be obtained from file INPUT. 

I=lfn2 Compiler input is obtained from file lfr^. Tape files must be BCD. 

I omitted Same as I=INPUT. 

L Specifies that the listing is to be written on file OUTPUT. 

L=lfn3 Output is to be written on file lfn3. 
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L=0 



L omitted 

N 

OB 
OB=lfn4 



Description 

Suppresses output except for errors. 

The L parameter may appear with one of the following suffixes to 
produce special listings. 

Suffix Meaning 

C Listing of items copied from user libraries 

M Data map 

O Object code in octal 

R Data-name and procedure -name cross-reference list with 

pointers to source lines 

X Extended diagnostics 

Same as L= OUTPUT. 

Directs the COBOL 4 compiler to issue an E type diagnostic if a 
non-ANSI feature is detected. 

Separates binary overlay segments | from main program and writes 
them on LGO. 

Specifies that binary output from overlay segments | is to be written 
on lfri4. 



OB omitted Same as OB. 



P 

S 

S=filenam 

S omitted 
SUB 

SUBM 



U 



Allows the user to execute a strict ANSI program. 

Specifies that external references are to be satisfied from the source 
library file COL IB. 

External references are to be satisfied from filenam, which contains 
the COBOL source library. 

Same as S. 

Suppresses data division binary output that duplicates output from a 
separately compiled main program, except for working storage and 
constant sections, so that the subprogram and main program can be 
loaded together. 

Identifies the COBOL program as a subprogram so that it can be called 
from a main program written in another language. 

Requests a tape sort rather than a disk sort. This requires four 
files which may be assigned to the disk. 

Allows use of a collating sequence other than the standard Control 
Data sequence. 



|NOS does not support segmentation. 
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v 



w 



Description 

If the loaded program is to be saved using NOGO with the file name 
specified, the V parameter must be specified for all COBOL/ SORT 
programs. Specifying this parameter causes the SORT code to be 
included in the program rather than being loaded dynamically. 

An independent segment! (priority number 50 through 99) may overlay 
or be overlaid by an overlayable fixed segment or another independent 
segment. In COBOL' version 4 and for ANSI programs, an independent 
segment is made available in its initial state. To override this usage 
and provide independent segments in their last used state so that 
COBOL 3 programs can be run without change, the W parameter must 
be included. 

Ensures compatibility with COBOL version 3 and turns on -the C and 
W parameters. 



COBOL5 STATEMENT 

The COBOL5 control statement calls the COBOL 5 compiler to a control point. Ex- 
ternal references are satisfied from the library COBOL 5. 

The control statement format is: 

COBOL5, p x , p 2 , . . . , p n . 

This control statement cannot be continued. The following parameters are supplied. 



ANSI 
ANSI=s 



ANSI 
omitted 

APO 



APO 

omitted 



Description 

Equivalent to ANSI=T. 

Language extensions that do not conform to ANSI X3. 23-1974, COBOL 
are diagnosed and treated as errors with severity specified by s. 

T Trivial error 

F Fatal error 

The EL=T parameter must be specified to obtain a listing of diag- 
nostics that note language extensions. 

Language extensions that do not conform to ANSI X3. 23-1974, COBOL 
are allowed. 

The ASCII apostrophe character with a display code value of 70 (Hol- 
lerith 11-8-5 punch, sometimes punched by an up arrow key) delimits 
nonnumeric literals. in the source program instead of the quotation 
mark character of display code value 64 (Hollerith 8-4 punch, some- 
times punched by a not equal sign). 

Nonnumeric literals in the source program are delimited by the quo- 
tation mark character that has a display code value of 64. 



t NOS does not support segmentation. 
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Pi 



Description 



B 

B=0 

B=lfn 



B 
omitted 

BL 

BL 
omitted 



CC1 



CC1 

omitted 

CPY 



CPY 
omitted 

D 

D=lfn 



D 
omitted 



DB 
DB=B 



DB=DL 



This option reverses the action of the ' and " so that the ' can be 
used within an alphanumeric literal the same as any other character. 

Within a source program, this option can be selected by the QUOTE 
IS APOSTROPHE clause of the SPECIAL-NAMES paragraph. 

Binary output from compilation is written to file BIN. 

No binary output is produced during compilation. 

Binary output from compilation is written to file lfn, with lfn being 
one through seven letters or digits beginning with a letter. 

Binary output from compilation is written to file LGO. 

Page eject occurs between various parts of the listing. 

Triple space separates the program listing, diagnostics, cross- 
reference listing, and any cross-reference map. 

Data items described as COMPUTATIONAL are stored and processed 
as COMPUTATIONAL -1 items. 

Selection of this parameter allows programs written for other com- 
pilers to gain the efficiencies of COMP-1 processing. 

Data items described as COMPUTATIONAL are stored and processed 
as COMPUTATIONAL items. 

COPY statements in the source program are compiled using the text 
on the UPDATE random program library file declared with the X • 
parameter. 

COPY statements do not appear in the source program; if they appear, 
they generate a fatal compilation error. 

Equivalent to D = SSFILE. 

Subschema for the CDCS interfaces resides on file lfn, where lfn is 
one through seven letters or digits beginning with a letter. 

Subschema for the CDC CYBER Database Control System is not used; 
if the SUB -SCHEMA appears in the program, it generates a fatal 
compilation' error. 

Equivalent to DB=DL/SB/B. 

Binary executable code is produced regardless of all errors in the 
source program. 

Lines with errors of severity C or F result in compilation of a call 
to an execution time abort routine; execution of those lines aborts the 
program. If DB=B is not selected, the first occurrence of a C or F 
error inhibits generation of executable code. 

Debugging lines in the source program (lines with a D in column 7) 
are compiled as executable code. 
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p. Description 

If DB=DL is not selected, all debugging lines are treated as comment 
lines, unless the WITH DEBUGGING MODE clause appears in the pro- 
gram. The presence of the WITH DEBUGGING MODE clause causes 
the DL option to be ignored. 

DB=SB Code compiled such that subscript and index references are checked 

during execution to ensure that all references to tables are within the 
table bounds. An out-of-bounds reference aborts the program with a 
dayfile message that identifies the line with the incorrect reference. 

If DB=SB is not selected, subscripted and indexed references are not 
checked during execution. 

DB=TR Paragraph trace occurs during execution. 

If DB=TR is not selected, paragraph trace does not occur, and any 
references to the trace directives called by ENTER statements result 
in a fatal error. 

Multiple options for the DB parameter can be specified by separating the options with 
a slash. 

DB omitted None of the debugging options applicable to this parameter are selected, 
or DB=0 

E Error information specified by the EL parameter is- written to the file 

ERRS. 

E=lfn Error information specified by the EL parameter is written to the 

file with the name lfn, where lfn is one through seven letters or 
digits beginning with a letter. 

E omitted Error information specified by the EL parameter is written to the file 
or EL=0 OUTPUT. 

When the L parameter specifies full listing, information written to the file specified 
by the E parameter is also written to the file specified by the L parameter. If the 
lfn specified by the E parameter is the same as that specified by the L parameter, 
information is written only to the error file. 

EL Equivalent to EL=W. 

EL=T Trivial errors plus all errors of levels W, F, and C are listed. 

Level T errors indicate a suspicious usage; although the syntax is 
correct, the usage is questionable. EL=T is required to obtain a 
listing of the messages reported as UNLISTED NON-ANSI ERRORS on 
the diagnostic' summary. 

EL=W Warning errors plus all errors of levels F and C are listed. 

Level W errors indicate the syntax of the statement is incorrect and 
the compiler has made an assumption and continued compilation. 

EL=F Fatal erros plus all level C errors are listed. 
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EL=C 



EL omitted 



ET=opt 



ET omitted 

I 
I=lfn 

I omitted 
L 

L=0 
L=lfn 

L omitted 

LBZ 



LBZ omitted 
LO 



Description 

Level F errors indicate an error that prevents compilation of the 
statement. Unresolvable semantic errors and propagated errors 
caused by earlier level F errors are among the causes of level F 
errors. 

Catastrophic errors are listed. 

Level C errors are fatal to compilation of the current program. Com- 
pilation resumes at the Identification Division header of any program 
immediately following without an intervening file boundary. 

Levels F and C errors are listed. 

Errors are listed on the file specified by the E parameter. 

The compiler aborts if the executable code contains any errors of at 
least the T, W, F, or C severity indicated by opt. Levels are those 
indicated by the EL parameter. 

Level T or W errors produce executable binary code. Level E and C 
errors produce a short, bad, binary program that causes the loader 
to inhibit loading, unless the B option of the DB parameter is 
specified. 

The job resumes after any EXIT(S) control statement in the job stream. 

The next control statement in the job stream is executed after termi- 
nation, despite any errors diagnosed during compilation. 

Card images of program to be compiled reside on file COMPILE. 

Card images of program to be compiled reside on file lfn, where lfn 
is one through seven letters or digits beginning with a letter. 

Card images of program to be compiled reside on file INPUT. 

Source listing, diagnostics, and information selected by the LO param- 
eter are written to file LIST. 

No listing is produced. 

Source listing, diagnostics, and information selected by the LO param- 
eter are written to file lfn, where lfn is one through seven letters. 

Source listing, diagnostics, and information selected by the LO param- 
eter are written to file OUTPUT. 

All leading blanks in numeric fields are treated as zeros in arithmetic 
statements and comparisons. 

Selection of this parameter significantly slows execution time and in- 
creases the size of compiled code. 

Numeric fields that contain blanks are in error. 

Equivalent to LO=S/M/R. 
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LO=0 

LO=M 

L0=0 
LO=R 

LO=S 



Description 

None of the information that can be selected by O, R, M, or S is 
listed. 

A map that correlates program entities, attributes such as data class 
and size, and physical storage is listed. 

Generated object code with COMPASS mnemonics is listed. 

Cross-reference of program entities and locations of definitions and 
use within the program are listed. 

Source program is listed. 



Multiple options for the LO parameter can be selected by separating the options with a 
slash. 



LO 

omitted 

MSB 



MSB 
omitted 

PD 

PD=3 

PD=4 

PD=6 

PD=8 



PD 
omitted 



Equivalent to LO=S. 



Program is compiled as a subroutine that includes COBOL initiation. 

This parameter should be used only when the COBOL program is 
called by a program written in a language other than COBOL. It 
should not be used for a COBOL subprogram that is called by another 
COBOL program. Only the first COBOL program called in a group 
of independently compiled subprograms should specify MSB. 

Normal program is compiled. 

Equivalent to PD=8. 

Listing specified by L and E parameters is double spaced at six lines 
per inch. 

Listing specified by L and E parameters is double spaced at eight 
lines per inch. 

Listing specified by L and E parameters is single spaced at six lines 
per inch. 

Listing specified by L and E parameters is single spaced at eight 
lines per inch. 

Equivalent to PD=6. 



The PD parameter is ignored for connected interactive terminal listings. Any option 
specified by this parameter must be supported by the printer on which the files are 
output. 



PS=n 



PS 
omitted 



Number of lines on a printed output page is n. 

Three lines exist at the top and at the bottom of each page, in 
addition to n. 

Number of lines on a printed output page is the density specified by 
[(PD parameter) multiplied by (IP. PS/IP. PD)] , where IP. PS and 
IP. PD are two installation parameters. 
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EL 

PW 
PW=n 



PW 
omitted 



Description 

Lines of printed output are 72 characters in length. 

Lines of printed output are n characters in length. The compiler 
reformats listing lines to this length. 

Lines of printed output are 136 characters in length. 



SB 



SB 
omitted 



Program is compiled as a subprogram. If the main program is not 
written in COBOL, the MSB parameter must also be used for one of 
the subprograms. 

Program is compiled as a main program. 



SY 



SY 
omitted 

U 

U=lfn 



U omitted 
or U=0 

UC1 



UC1 
omitted 



Source program is checked for syntax, but executable code is not 
generated. 

When SY is selected, compilation time is approximately half that 
required when SY is omitted. 

Source program is compiled and executable code is generated. 

Equivalent to U=COMPS. 

COMPASS line images of the generated program are written to file 
lfn in a format acceptable for the UPDATE utility, where lfn is one 
through seven letters or digits beginning with a letter. 

The first seven characters from the name in the PROGRAM -ID para- 
graph become the deck name on a *DECK image written as the first 
item on the file. The second image on the file is *IDENT with the 
same name as the deck name. 

COMPASS assembly language images are not produced. 

Ail COMP-1 items are converted to integer format before they are 
processed. 

Conversion occurs through the use of an unpack instruction that re- 
moves the exponent. UC1 should be used only when files created by 
COBOL 4 are being processed under COBOL 5. COMP-1 items in 
COBOL 4 have a different format in COBOL 5. Larger and slower 
object programs result from this parameter. 

All COMP-1 items are processed in COMP-1 format. 



X 
X=lfn 



X omitted 
or X=0 



Equivalent to X=NEWPL. 

The UPDATE random program library containing text for COPY state 
ments is on file lfn, where lfn is one through seven letters or digits 
beginning with a letter. 

Equivalent to X=OLDPL. 
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FTN STATEMENT 



The FTN control statement calls the FORTRAN Extended compiler to a control point. 
The minimum memory requirement for FORTRAN Extended is 46,000 octal locations. 
FTN externals are satisfied from the user library FORTRAN. 

The control statement format is: 

FTN, p r p 2 , ...,p n . 



A 

A=0 

A omitted 

B 

B=lfn t 

B=0 

B omitted 

BL 



Description 

Branches to EXIT control statement if fatal compilation error occurs. 
If there is no EXIT statement, the job terminates. 

Control transfers to the next control statement, regardless of the 
installation default, if fatal compilation errors occur. 

Same as A=0. 

Object code is written in file LGO. 

Object code is written on file lfn.. . 

Suppresses object code output. 

Same as B=LGO. 

Generates output listing that is easily separable into components by 
issuing page ejects between source code, error summary (if present), 
cross-reference map, and object code (if requested), and ensures 
that each program unit listing contains an even number of pages (page 
parity) by issuing a blank page at the end if necessary. 



BL=0 



Listings are produced in compact format. 

BL omitted Same as BL=0. 

C Uses COMPASS assembler for compiler -generated code. 

C=0 Selects the FTN assembler regardless of the installation default. 

C omitted Same as C=0. 

The C option conflicts with the E, Q, and TS options. 

D Debug mode of compilation; a minimum of 61,0008 locations is re- 

quired if this option is selected. Debug input is obtained from INPUT 
source. 

D=lfn„ Debug input is obtained from lfn ? . 

D=0 Debug statements are ignored. 

D omitted Same as D=0. 

The D option conflicts with the TS option. 
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L 



Description 



E Compiler -generated object code on file COMPS is output as COMPASS 

line images for input to Update. 

E=lfn 3 Compiler -generated object code on lfn 3 is output as COMPASS line 

images for input to Update. 

E=0 Normal binary object file is generated. 

E omitted Same as E=0. 

EL=fi Lists diagnostics according to list specification fi: 

£ Description 

A Lists diagnostics indicating all non-ANSI usages, as well 

as fatal diagnostics. Also, lists informative diagnostics 
if compiling under OPT=0, 1, or 2; lists note and warn- 
ing diagnostics if compiling in TS mode. 

I Lists informative and fatal diagnostics if compiling under 

OPT=0, 1, or 2; lists note, warning, and fatal diagnostics 
if compiling in TS mode. 

N Lists note, warning, and fatal diagnostics if compiling in 

TS mode; lists fatal diagnostics if compiling under OPT= 
0, 1, or 2. 

W Lists warning and fatal diagnostics if compiling in TS 

modes; lists fatal diagnostics if compiling under OPT= 
0, 1, or 2. 

F Lists fatal diagnostics. 

EL omitted Same as EL=I. 

ER Includes code for object time reprieve. 

ER=0 No object time reprieve code is included. 

ER omitted The same as ER if TS=0 or OPT=0. The same as ER=0 if OPT=l 
or 2. 

G Loads the first system text overlay from the sequential binary file 

SYSTEXT. A maximum of seven system texts can be specified by 
any combination of the G, S, and C parameters. 



G=lfn. Loads the first system text overlay from the sequential binary file 

lfn 4 . 

G=lfn 4 /ovl Searches the sequential binary file, lfn^ for a system text overlay 
with the name ovl and loads the first such overlay encountered. 

G=0 No system text is loaded. 

G omitted Same as G=0. 

GO Binary object file is loaded and executed at end of compilation. 

GO=0 Binary object file is not loaded and executed. 
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Description 



GO omitted Same as GOO. 



I 

I=lfn 5 
I omitted 
L 

L=lfn 6 
L=0 

L omitted 
LCM=D 

LCM=I 



LCM 

LCM omit- 
ted 



Source input is on file COMPILE. 

Source input is on file lfn 5 . 

Same as 1= INPUT. 

Listable output (specified by list control options BL, EL, OL, R, 
and SL) is to be written onto file OUTPUT. If list control options 
are not specified, the listing consists of the source program, infor- 
mative and fatal diagnostics, and a short reference map. 

Listable output is to be written onto file lfn fi . 

Fatal diagnostics and the statements that caused them are listed on 
the file OUTPUT. All other compile -time output, including inter- 
mixed COMPASS, is suppressed. List control options are ignored. 

Same as L=OUTPUT. 

Selects 17-bit address mode for level 3 data. This method produces 
more efficient code for accessing data assigned to level 3. User ECS 
field length must not exceed 131,071 words. If the LCM parameter is 
omitted, this option is assumed. 

Selects 21 -bit address mode for level 3 data. This mode depends 
heavily upon indirect addressing. LCM=I must be specified if the 
execution ECS field length exceeds 131,071 words. In TS mode, all 
LCM addressing is done in 21 -bit mode, regardless of the LCM 
parameter. 

Same as LCM=D. 

Same as LCM=D. 



In time-sharing mode, all addressing is done in 21 -bit mode, regardless of the 
LCM specification. 

ML Current data in the form yyddd is used for the MODLEVEL micro. 

ML=nnn Specifies nnn as the value of the MODLEVEL micro used by COMPASS, 

nnn consists of one to seven alphanumeric characters. 

ML omitted Same as ML. 

OL Generated object code is listed on the file specified by the L 

parameter. 

OL=0 Object code is not listed. 

OL omitted Same as OL=0. 
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p^ Description 

OPT=n Level of optimization: 

n=0 Fast compilation (automatically activates T option). 

n=l Standard compilation and execution (default value). 

n=2 Fast execution. OPT=2 is equivalent to OPT. 

OPT omit- Same as OPT=l. 
ted 

P Page numbering is continuous from subprogram to subprogram, in- 

cluding intermixed COMPASS. If P is omitted, page numbers begin 
at 1 for each subprogram. 

P=0 Page numbers begin at 1 for each subprogram. 

P omitted Same as P=0. 

PD Same as PD=8. 

PD=6 Print density 6 lines per inch. 

PD=8 Print density 8 lines per inch. 

PD omitted Same as PD=6. 

PL=n n is the maximum number of records produced by the user program 

at execution time which can be written on the file OUTPUT. n does 
not include the number of records in the source program listing 
and compilation and execution time listings: n ^ 999 999 999. 

PL=nB An octal number must be suffixed with a B; n < 77 777 777. 

PL omitted Same as PL=5000. 

PS=n n is the maximum number of lines per page. 

PS omitted Same as PS=60. 

PW Specifies 72 -character page width. This option is valid only for time- 

sharing origin jobs. 

PW=n Specifies page width of n characters (50< n< 136). This option is 

valid only for time -sharing origin jobs. 

PW omit- Same as PW=1'26 if the output goes to a printer. Same as PW=72 if 
ted the output goes to a terminal. 

Q Compiler performs full syntactic scan of the program, but no object 

code is produced. No code addresses are provided if a reference 
map is requested. This mode is substantially faster than a normal 
compilation, but it should not be selected if the program is to be 
executed. 

Q=0 Normal compilation. 
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p. Description 

Q omitted Same as Q=0. 

The Q option conflicts with the B, C, GO, OL, TS, and E options. 



R=n 



R omitted 
ROUND=s 

ROUND=0 

ROUND 

ROUND 
omitted 

S=ovl 

S=lib/ovl 

S=0 

S omitted 
SEQ 

SEQ=0 

SEQ omit- 
ted 



Selects the kind of reference map required; 

n=0 No map 

n=l Short map (symbols, addresses, properties, and a DO- 

loop map) 

n=2 Long map (short map plus references by line number) 

n=3 Long map with printout of common block members and 

equivalence groups 

In time -sharing mode, R = 3 and R-2 are the same. Common and 
equivalence groups are not listed. 

Same as R = l. 

Directs the compiler to produce code that rounds arithmetic operations 
involving the following operators: (s = */+ or -). 

Computation for the indicated operators is not rounded. 

Implies ROUND=+-*/ 

Same as ROUND=0. 



The system text overlay, ovl, is loaded from the job's current 
library set. 

The system text overlay, ovl, is loaded from lib. lib can be a 
user library file or a system library. 

When COMPASS is called to assemble any intermixed COMPASS pro- 
grams, it will not read in a system text file. 

Same as S=SYSTEXT if G=0. Same as S=0 if G^O. 

Source input file is in sequenced line format. Specifying this option 
automatically activates the TS option. 

Source input file is in standard FORTRAN format. 

Same as SEQ=0. 



The SEQ option conflicts with the OPT= 0, 1, or 2 option. 

SL Source program is listed on the file specified by the L parameter. 

SL=0 Source program is not listed. 

SL omitted Same as SL. 
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El 

SYSEDIT 



Description 



All input/output references are accomplished indirectly through a table 
search at object time. File names are not entry points in main pro- 
gram, and subprograms do not produce external references to the 
same file. 

SYSEDIT=0 Input/output references accomplished directly; file names are used as 
entry points in the main program, and subprograms produce external 
references to the file name. 



SYSEDIT 
omitted 



Same as SYSEDIT=0. 



This feature is used primarily for system-resident programs. 

T If this parameter is specified, full error traceback occurs. This is 

primarily used for programs in debug stages. Selecting the D param- 
eter or OPT=0 automatically activates the T option. 

T=0 No traceback occurs when an error is detected. 

T omitted Same as T=0. 

TS Time -sharing mode. Compilation speed and field length are optimized 

at the expense of execution speed and field length. TS mode is 
preferable to the optimizing compilation modes (OPT-1, 2, or 3) for 
the debugging stages of a program. Specifying the TS option together 
with the C, D, E, or Q option constitutes a fatal control statement 
error. 

TS omitted Same as specifying OPT=l. 



UO 



This allows the compiler to perform potentially unsafe optimizations. 
The UO parameter is ignored unless OPT=2 is also specified. 



UO=0 Unsafe optimization is not performed. 

UO omitted Same as UO=0. 



X 



X=lfn, 



File OPL is the source of external text (XTEXT) when location field 
of XTEXT pseudo instruction is blank. Only one X parameter may 
be specified. 



External text on file lfn 



7* 



X omitted External text is on OLDPL. 

This feature is for COMPASS subprograms only. 

Z When Z is specified, all subroutine calls having no parameters are 

forced to pass a parameter list consisting of a zero word. This 
feature is useful to COMPASS-coded subroutines expecting a variable 
number of parameters. Z should not be specified unless necessary, 
since programs require less memory if Z is omitted. 

Z=0 A zero word parameter list is not passed. 
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p. Description 

Z omitted Same as Z=0. 

SORTMRG STATEMENT 

The SORTMRG control statement calls Sort/Merge to process a logical record of di- 
rectives. The minimum memory requirement for Sort/Merge is 25,000 octal locations. 

The control statement format is: 

SORTMRG(p r P 2 , ...,p n ) 

p. Description 



I Sort /Merge directives are on file COMPILE. 

I=lfn 1 /r 1 Sort/Merge directives are on file lfn- with the following rewind options. 

r^ Description 

R File is rewound before opening. If system INPUT file 

is indicated, R should not be specified. 

NR File is not rewound before opening. This option is 

assumed if r« is not specified. 

I omitted Same as 1= INPUT. 

MO=n Intermediate merge order, 2< n< 64. In general, higher merge orders 

produce faster sorts at the expense of greater field length require- 
ments. If insufficient core is available to merge at the requested 
order, a fatal error occurs, and a diagnostic indicates how much ad- 
ditional core is required. 

MO=*n Intermediate merge order, 2<; n< 64. If insufficient core is available 

to merge at the requested order, merge will take place at a smaller 
order, and an informative diagnostic is issued. 

MO omitted The installation default merge order is used (release system default 
is 5). 

O Listings will be written to the file OUTPUT. 

0=lfn 2 /r 2 Listings are written to file lfn„ with the following rewind options. 

r 2 Description 

R File is rewound before opening. If system OUTPUT 

file is indicated, R should not be specified. 

NR File is not rewound before opening. This option is 

assumed if r 2 is not specified. 

O omitted Same as 0=OUTPUT. 

OWN Owncode binaries are on file LGO. If the OWN parameter is omitted, 

owncode binaries are on file INPUT. 
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Pi Description 

OWN=lfn 3 / Owncode binaries are located on file lfng with the following rewind 
rg options. 

r% Description 

R File is rewound before opening. If system INPUT file 

is indicated, R should not be specified. 

NR File is. not rewound before opening. This option is 

assumed if r, is not specified. 

OWN omit- Owncode binaries are on file INPUT, 
ted 
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CHECKPOINT/RESTART 12 



A job may be terminated at any time as the result of system, operator, or programmer 
error. For some jobs, it becomes more advantageous to accept the overhead of check- 
point procedures than to run the risk of losing the entire job output. The checkpoint/ 
restart feature is implemented, through the CKP control statement and the RESTART 
control statement. 



NOTE | 



For information concerning security restrictions 
associated with the use of these control statements, 
refer to Security Control, section 3. 



CKP STATEMENT 



The CKP control statement causes a checkpoint dump to be taken. 

The control statement format is: 

CKPdfn^lfng, ...,lfn n ) 

lfni Specifies a file to be included in the checkpoint dump. If no files 

are specified, all files local to the job at the time the CKP statement 
is processed will be checkpointed. 

Each time a CKP statement is processed, the system takes a checkpoint dump. The 
dump is written on the tape or mass storage checkpoint file specified on a REQUEST, 
ASSIGN, or LABEL control statements with the CK parameter. The dump consists of | 
a copy of the user's central memory, the system information used for job control, and | 
the names and contents of all assigned files explicitly or implicitly identified by the 
CKP statement. These files are: 

• INPUT, OUTPUT, PUNCH, PUNCHB, P8, CCCCCCO, and LGO. These files 
are always included in the checkpoint dump. 

• Common files, library type files, working copies 01 indirect access files, and 
some direct access files. If one of these types of files is specified on the 
CKP statement, it is. included in the checkpoint dump, and all other files of 
that type are excluded. If no files are specified, all files of these types 
assigned to the job are included in the dump. 

Each checkpointed file is copied according to the last operation performed on it. If 
the last operation was a write, the file is copied from the BOI to its position at 
checkpoint time; only that portion will be available at restart time. The file is posi- 
tioned at the latter point. 

If the last operation was a read and the EOI was not detected, the file is copied from 
its position at checkpoint time to the EOI; only that portion will be available at restart 
time. The file is positioned at the former point. If the last operation was a read 
and the EOI was detected, no copy is performed. 
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The exception to this rule is the type of operation performed on execute -only direct 
access files. If a dump is specified f6r this type of file, its name and associated sys- 
tem information are copied but the contents of the file . itself is not copied. Thus, if 
the user attempts to resume from such a dump, RESTART will be unable to retrieve 
that file and will abort. The user can avoid this by selecting the NA and FC options 
of the RESTART statement and retrieving the file himself. 

If the checkpoint file is to reside on mass storage, the user must include a SAVE or 
DEFINE control statement in the checkpoint job and a GET or ATTACH control state- 
ment in the restart job. 

If the checkpoint file is to reside on magnetic tape, care should be taken to use a 
labeled or nonblank tape. An unlabeled blank tape (one which has never been used) 
cannot be specified as the checkpoint file since the checkpoint program attempts to 
read the tape to determine the number of the last checkpoint. The tape subsystem 
then aborts the job with a blank tape read message. 

The system numbers checkpoints starting at 1 and increments by 1 to a limit of 4095. 
At this point, a second cycle of numbering begins, again starting at 1. An example 
showing how to restart from a specific checkpoint is given in the RESTART control 
statement section. 

RESTART STATEMENT 

The RESTART control statement directs the system to restart a previously terminated 
job from a specified checkpoint. 

The control statement format is: 

RESTART(lfn, nnnn, x L ) 

lfn Identifies the checkpoint file; the user must have write permission 

to lfn. 

nnnn Number of the checkpoint from which to restart; if nnnn is *, the 

last available checkpoint on lfn is used; if nnnn is omitted, the 
first checkpoint is used. The nnnn parameter can be obtained 
from the CHECKPOINT nnnn COMPLETE messages issued to the 
user's dayfile in response to CKP control statements. 

x. Any of the following in any order: 

RI If this parameter is included, the control statement file 

on lfn is not restored. The control statement file of 
this restart job at its current position is used instead. 
If this parameter is not included, the entire control 
statement file of the checkpointed job is restored and 
set to its position at checkpoint time; any control state- 
ments following RESTART are not processed. 

NA If this parameter is included, RESTART does not abort if 

a required file is not available. Also, if NA is included 
and a read parity error occurs in an attempt to obtain 
a file from checkpoint nnnn, RESTART selects check- 
point nnnn-1 if it is available. 

FC Normally RESTART restores all files included in the 

specified checkpoint. However, if this option is select- 
ed, RESTART first checks if a file is already local to 
the restart job. If it is, RESTART does not replace 
it with the file on the checkpoint dump. 
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The user must assign lfn to his job before the RESTART statement is processed. He 
must include a REQUEST, ASSIGN, or LABEL control statement if lfn resides on mag- 
netic tape or a GET or ATTACH control statement if lfn resides on mass storage. 

Checkpoint dumps are numbered in ascending order from 1 to 4095. When nnnn=4095, 
the numbering sequence begins again at nnnn=l. The value of nnnn depends on the 
structure of the checkpoint file, as defined by the CK and CB parameters of the RE- 
QUEST, ASSIGN, or LABEL control statements. 

If CK was specified when the checkpoints occurred, each dump is appended to the 
checkpoint file, and therefore, all dumps up to the time the job aborted are available 
for restart. The user may specify a particular checkpoint dump in the following man- 
ner. 

Assume a CK file of the name CHKFILE is being used and checkpoint number 4095 has 
been passed. The job is terminated at checkpoint number 10 in the second cycle of 
numbering. To restart the job from checkpoint 4 of the second numbering cycle, the 
following control statements can be used. 



SKIPR (CHKFILE, 8196) 



COPYBR(CHKFILE, AA, 2) 



RESTART(AA. . . ) 



There are two records for every checkpoint, and 
4098 checkpoints must be skipped to reach check- 
point 4 of the second numbering cycle. 

The fourth checkpoint is copied to file AA. At this 
point, file CHKFILE is not positioned correctly for 
subsequent checkpoints. If the user intends to continue 
checkpointing on this file, a 

BKSP, CHKFILE. 

statement should be included. 

The job is restarted from file AA using the fourth 
checkpoint. 



If CB was specified when the checkpoints occurred, each dump is- written over the 
preceding dump, and therefore, only the last dump is available. If two REQUEST, 
ASSIGN, or LABEL statements are submitted, successive CB-type dumps are alter- 
nated between two files; therefore, the last two dumps are available.! 

All files copied by RESTART are made local to the restart job. Therefore, the user 
must make sure that any direct access files are not lost. For example, assume that 
direct access files X, Y, and Z are attached to a job. The job is then checkpointed 
and X, Y, and Z are copied to the checkpoint file lfn. To retain these files as direct 
access files during restart, the user should include the following sequence of control 
cards. 

PURGE(X, Y, Z) 

DEFINE(X, Y,Z) 

RESTART (lfn, nnnn, x L ) 

If the information table associated with a file was included on the checkpoint file, but 
the file itself was not copied, RESTART issues the appropriate commands to retrieve 
the file. 



t If alternate checkpoint files are used and a read parity error occurs in an attempt to 
read the last checkpoint, RESTART will abort even if the NA option was selected. 
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DEBUGGING AIDS 



13 



This section contains a description of central memory dumps and their use as a debug- 
ging aid. This information should be of considerable assistance to the user in finding 
errors in his program. 



CENTRAL MEMORY DUMPS 



The first line of a dump gives the boundaries of the memory that is dumped, relative 
to the user's field length. Four central memory words are printed per line, with the 
address of the leftmost word printed on the left-hand side of the page. When the phrase 
DUPLICATED LINES appears within the dump, all groups of four words not printed are 
exactly like the last group of four words. Each word is divided into four groups of 
15. bits, with the octal representation printed. Figure 1-13-10 is an example of a cen- 
tral memory dump. Section 9 describes the options of the DMP control statement that 
can be used to obtain various dumps. 



The user may also dump his exchange package, 
the actual exchange package. 



Figure 1-13-1 illustrates the format of 
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Figure 1-13-1. Exchange Package 
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P Program address currently being executed 

RA Reference address, beginning address of the associated field length 

[central memory (CM), extended core storage (ECS)] 

FL Field length 

EM-M Program error exit mode (refer to section 6) 

EM-N Hardware error exit mode (refer to section 6) 

MA Monitor address 

An Address registers 

Bn Increment registers 

Xn Operand registers 

When the user requests this form of a dump, he also receives the following information. 

9 The contents of memory at the address contained by the A registers, 
identified as (An) 

• The contents of RA (reference address) and RA+1, identified as (RA) and 
(RA+1), respectively 

• 40„ locations before and after the address contained in P (100 R locations total) 
Figure 1-13-9 illustrates an example of this exchange package dump. 

GENERATING MEANINGFUL DUMPS 

The following methods are used to generate meaningful central memory dumps. 

e Error Exit Control 

By using the EREXIT macro within his COMPASS program, the user can direct 
execution when certain errors occur, rather than having his program completely 
halt execution. This enables him to use it as a checkpoint method (that is, to 
save generated data to this point). It could also enable him to do further cal- 
culations or to write pertinent data to an output file. Refer to section 6, 
volume 2 for a description of' this macro. 

• EXIT/NOEXIT/ONEXIT Control 

Once program execution ceases, due to an error condition, and control state- 
ment processing is resumed, the user can direct which statements are to be 
processed through the us e of the EXIT, NOEXIT , and ONEXIT statements. 
Upon an error condition, the user can issue the DMP control statements to 
obtain appropriate dumps. For a detailed description of these control state- 
ments, refer to section 6. 

e Dumps may also be generated under control of the user's program through the 
use of the SYSTEM macro. The FORTRAN user can generate dumps by calling 
the DUMP subroutine. 
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READING CM DUMPS 

Figures 1-13-2 through 1-13-10 are output from a FORTRAN program source deck 
processed by the following sequence of control statements. 

TEST(CM50000,T10) 

USER (ABCB, PASS, FAMA) 

SET CORE, 0. 

MAP. 

FTN. 

LGO. 

OVLA. 

DMP. 

DMP, 1000. 

The source deck in the example consists of four parts. 

• Main program (main overlay) 

• Function subprogram 

• Subroutine subprogram 

• Primary overlay 

Each part is listed separately followed by the corresponding address assignments, 
such as variable assignments, program length, common blocks, etc. (refer to 
figure 1-13-2). 

Figures 1-13-6 and 1-13-7 illustrate the load map generated by the MAP control state- 
ments. The load map gives the address and references of all entry points. Maps are 
listed separately for each overlay. Output generated by the program follows the load 
map (refer to figure 1-13-8). 

Figures 1-13-9 and 1-13-10 illustrate central memory dumps generated by the DMP. 
and DMP, 1000. control statements, respectively. 

The, following examples illustrate the use of these dumps to obtain specific information. 
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Example 1; (Finding Data Locations in a Core Dump) 

Referring to figure 1-13-2, the variable I is used as the control variable in the DO 
loop defined by statements 10 through 20. To find the value of I at job termination, 
the following steps must be performed. 

1. Find I in the variable assignments (lower half of figure 1-13-2), noting I is 
at relative address 4167,,. 

2. Find the first word address (FWA) of the main overlay TESTA. (Refer to the 
load map, figure 1-13-6.) The FWA of TESTA is 143 g . 

3. Add (143 g + 4167 g = 4332 g ) to obtain the absolute address of I. 

4. In figure 1-13-10, address 4332 contains 0013 g (1LJ. This should be the 
last value of I. 

Example 2; (Finding Data Locations in a Core Dump) 

To find the variable B(3), the following points must be considered. 

• Find B in the variable assignments (lower half of figure 1-13-2). The value is 
12, which means that B begins at relative location 12s of common block AAA. 
By referring to the map (figure 1-13-6), note that AAA begins at absolute 
address 101s. Therefore, 101s + 12s (relative location of B) equals 113s, 

the beginning address of array B. B(l) is 113s» and the address of B(3) is 
115 8 . 

• The location in core of the B array is illustrated in figure 1-13-10. 

Example 3: (Finding an Address Within the Program) 

Referring to figure 1-13-9, note that the program stopped at address 10114 (the value 
of P). To find where this is in the program, the following points must be considered. 

• Figure 1-13-6 or 1-13-7 contains the routine addresses. 

• Figure 1-13-6 illustrates that routine SYS. RM is at address 10114. This 
means the program ended in routine SYS. RM. 
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10 



15 



20 



25 



OVERLAY (OVL A, 0,0) 
PROGRAM TESTAUMPUT, OUTPUT) 

COMMON/ /Ed 0) , 

COMMON/ AAA/ A (10) ,B( 10) ,C (3,3) 

COMMON/ BLOCK A/BL< (5» 

DIMENSION N(50) 

DATA (A(I),I=1,10)/1. i2.»3.,*». ,5 . ,6., 7., 8., 9. ,10./ 

OATA (B(I),I = l,5)/iO0.,2OQ.,30 0. ,<»00. ,500./ 

DATA (B(I),I=6',10>/60 0.,70 0.,800.,900.,1000./ 

OATA C(l,l) ,C(1,2),C(1,3)/101. ,202., 30 3./ 

OATA C(2,l) ,C(2,2),C(2,3)/2.1,2.2,2.3/ 

OATA C(3,l) ,C(3,2),C(3,3)/3.1, 3.2,3.3/ 

OATA (N<J),J=i,50)/50»123/ 

CALL OVERLAY UHOrfLA, 1,0) 

CALL PRNT (BLOCKA) 

DO 30 1=1,10 

A(I)=A(I)»A(I) 

A(I)=TRY(A(I),A(D) 
30 B(I)=TRI(A(I),A(D) 

DO 35 J*l,5 
35 BLK(J) a A(J)+A(2*J) 

CALL OVERLAY(i»HDVLA,l,0) 

CALL PRNT (BLOCKA) 

C(1,1) = J 

END 



SYMBOLIC REFERENCE MAP (R=l ) 



ENTRY POINTS 
M07 TESTA 
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Figure 1-13-3. Function Subroutine of Main Overlay (0, 0) 



10 



SUBROUTINE PRNT(A) 

COMMON/ /O (100) 

COMMON/ AAA/ P (29) 

COMMON/ A/SUB (S) 

B=0 

DO 50 1=1,29 
50 B=B+P(I) 

PRINT 55,8, (SUB(I),I=1,5) 
5F FORMAT (1X.6F17.7) 

RETURN 

END 



SYMBOLIC REFERENCE MAP (R=l) 



ENTRY POINTS 
3 PRNT 










VARIABLES 
A 



P 


SS 


TYPE 
REAL 
REAL 
REAL 


RELOCATION 
♦UNUSED F.P. 
ARRAY / / 
ARRAY AAA 


26 
27 




FILE NAMES 

OUTPUT 




MODE 
FMT 






STATEMENT LABELS 
50 




Zk 


55 FM 


LOOPS LABEL 
11 50 




INOEX 
I 


FROM-TO LENGTH 
6 7 3B 


PROPERTIES 
INSTACK 


COMMON BLOCKS 
/ / 
AAA 
A 




LENGTH 

100 

29 

5 







B 
I 
SUB 



REAL 

INTEGER 

REAL 



ARRAY 



STATISTICS 

PROGRAM LENGTH 

CM LABELED COMMON LENGTH 

CM BLANK COMMON LENGTH 



309 


2(f 


i»2B 


3<» 


l<f«»3 


100 



Figure 1-13-4. Subroutine of Main Overlay (0, 0) 



1-13-6 



60435400 A 



1 OVERLAY <OVLA,1,0) 

PROGRAM OVL10 
COMMON/ AAA/W (29) 
PRINT 105,(W{I),I=1,7) 

5 PRINT 105,(W(I),I=8,i«O 

PRINT 105,(H(I) f I=l5,21) 
PRINT 105, (H(I), 1=22, 28) 
PRINT 106,(H(29>> 
105 F0RMAT(1X,7F17.7> 
10 106 FORMAT UX, F17.7) 

END 



SYMBOLIC REFERENCE MAP (R=l) 

ENTRY POINTS 
3 OVL10 

VARIABLES S^ TYPE RELOCATION 

«»7 I INTEGER Q M REAL ARRAY AAA 

FILE NAHES MOOE 

OUTPUT FMT 

STATEMENT LA8EL5 

*»3 105 ^MT £f5 106 FMT 

COMMON BLOCKS LENGTH 
AAA 29 

STATISTICS 

PROGRAM. LENGTH 

BUFFER LENGTH 

CM LABELEO COMMON LENGTH 



Figure 1-I3r5. Main Program of Primary Overlay (1,0) 



V73 


39 


IB 


1 


35B 


29 



60435400 A 1-13-7 



LOAD MAP - T^STA 
0VERLAY(3\/LA,0,0I 



CY3ER LOADER 1.0-J401 



75/05/29. 11.01.07. 



PAGE 



3VERLAY(3VLA f f 0> 

r *A 3F HE L3AO 101 

LHAU OF THE LOAD 17032 

TRANSFER A3D?EiS ~ TESTA 



42>2 



PROGRAM AND 3LOCK ASSIG NME-ITS. 
3L0C< AJGPES3 LENGTH 



r I.E 



OATE 



PRDCi-SR VER LEVEL HARDWARE 



COMMENTS 



/AAA/ 


101 


3> 














/3L0CKA/ 


136 


5 














TESTA 


143 


*»257 


-G3 


7P/03/29 


^TM 


4. it 


U401 


665X I 


TRY 


*4 22 


3; 


.GO 


75/05/29 


FM 


4.4 


U401 


666X I 


/A/ 


Wt\>? 


7 














PRNT 


<«464 


30 


.GO 


7S/03/29 


FT-J 


<*.<* 


U401 


6C6X I 


/an. io./ 


ubm 


13V 














/IOCON./ 


4650 


42 














SOHIOs 


m712 


t>l 


3L--0RTRA-J 


75/03/27 


331PASS 


3. 


75036 




-LTOJT= 


1,7/5 


311 


SL--ORTRAM 


75/03/27 


331PASS 


3. 


75086 




-MTA^r 


>306 


351 


Su-F3RTRA>1 


7-J/03/27 


33<PASS 


3. 


75096 




"JRSY3= 


i>657 


6i-» 


SL- r ORTRA>l 


75/03/27 


331PASS 


3. 


75086 




3ETFIT= 


i5 33 


42 


SL- r ORTRAJ 


75/03/27 


sdipass 


3. 


75096 




<03ER= 


65 75 


*57 


SL- r ORTRA^ 


75/03/27 


33iPASS 


3. 


75086 




3JTC= 


725<* 


172 


SL- r ORTRAN 


75/03/2? 


:3-ipass 


3. 


75086 




OJTCOM= 


7446 


153 


SL-FORTRAJ 


75/03/2? 


:d-ipass 


3. 


75086 




3VERLAY 


7621 


143 


3L-FORT<A^ 


75/03/27 


:3<pass 


3. 


75086 




33.RT 


7764 


43 


SL-FORTRA'I 


75/03/27 


^31PfiSS 


3. 


75096 




3VSAI0= 


10027 


1 


SL-FORTRA'J 


75/03/27 


;31PASS 


3. 


75086 




SYS=1ST 


lil 30 


62 


SL-FORTRA^ 


75/03/27 


:dipass 


3. 


75086 




SY3.RM 


10112 


50 


3L-SYSI0 


75/03/2? 


331PASS 


3. 


75036 




J3L0A0 


101fa2 


25J 


3L-SY3ID 


75/03/27 


C31PASS 


3. 


75086 




/JiPS.RM/ 


10<*40 


11 














i.3UF.SQ 


10451 


133 


SL-3YSI3 


75/03/27 


D3-1PAS3 


3. 


75086 




/ 3 ON. KM/ 


10604 


3 














313. RM 


1U612 


34 


SL-3Y3I3 


75/03/27 


331PASS 


3. 


75086 




/A03.R*/ 


10b<t6 


10 














ERR.RM 


10656 


404 


SL-3Y5I3 


7s/03/?? 


331PASS 


3. 


75096 




13VE.R1 


11262 


6+ 


SL-3Y3IO 


75/03/2? 


334PASS 


3. 


75096 




3HHR.SQ 


11346 


7 


SL-SY3I3 


75/03/2? 


334PASS 


3. 


75086 




1CT.RM 


11355 


233 


3L-3Y3IO 


75/03/27 


CDIPmSS 


3. 


75086 




/MEMC.RM/ 


11610 


3 














/3PES.F0/ 


11613 


1 














/3PEM.F0/ 


11614 


7 














OPEM.RM 


11623 


234 


3L-3YSI0 


75/03/2/ 


C3-1PASS 


3. 


75086 




33J3.RM 


120 57 


73 


SL-SY3I3 


75/03/27 


sdipass 


3. 


75096 




3PEN.SQ 


12152 


260 


3L->YSI3 


75/03/27 


334PASS 


3. 


75096 




3PEX.SQ 


124 32 


1* 


3L-SY5I3 


75/03/27 


C34PASS 


3. 


75096 




/PUT.RT/ 


12446 


11 














Ri.EQ.RM 


12457 


42 


SL-3Y3I3 


7^/03/27 


C34PA55 


3. 


75096 




/TER1.RM/ 


125 21 


1 














/pur.Fo/ 


12522 


? 














PUT. SO 


12531 


12 7.' 


SL-JY3I3 


75/03/27 


33HPASS 


3. 


75096 




HAR.3Q 


1*»0 30 


260 


SL-3Y3I3 


75/03/27 


33«PASS 


3. 


75096 




/3lSF.F0/ 


1U310 


7 














3LSF.R1 


H.317 


23 


3L-3Y31D 


75/03/27 


S34PAS3 


3. 


75086 




3LSF.SQ 


1*342 


131 


SL-3Y3I3 


75/03/27 


:3<PASS 


3. 


750 86 




/3LSV.F0/ 


1-473 


7 














3L3V.SQ 


li.502 


123 


3L-iY5I3 


75/03/27 


334PA3S 


3. 


75086 




/3ET.FO/ 


1^.625 


7 














/3ET.BT/ 


14634 


5 














/GET.RT/ 


1^641 


11 














3ET.3Q 


1^652 


1027 


SL-SY5I3 


71/03/27 


33-1 PASS 


3. 


75086 




Z.SQ 


li.701 


101 


3L-5Y3ID 


7 s /03/2? 


C3-1PASS 


3. 


750 86 




F5J.3Q 


16002 


105 


SL-5Y3IO 


75/03/2'' 


33 * PASS 


3. 


75096 




3TRT.SQ 


16110 


11 + 


SL-SY3ID 


75/03/27 


^3^PASS 


3. 


75035 




lXER.SQ 


16224 


220 


3L-3Y3I3 


73/03/2? 


33*PASS 


3. 


75086 




rtEOX.SQ 


16444 


144 


SL-SYSI3 


75/03/2? 


331PASS 


3. 


75086 




/3KF...FO/ 


l'i610 


7 














3<FL.SQ 


1^617 


4 7 


SL-3YSI3 


7s/ 03/2 7 


331PA53 


3. 


75036 




// 


1666b 


14* 















0»T=1 
0PT=1 



0PT=1 



C01M3N CJOED I/O R3JTINES AND CONSTANTS. 

C31MON FLOATING OUTPJT CODE 

CRACK APLIST AND FORI AT FOR KOOER/KRAKER. 

F3RTRAN 03JECT LIBRARY UTILITIES. 

LJ3ATE AN FIT GIVEN A FILE NAME. 

OJTPJT FORMAT INTERPRETER. 

F3R1ATHJ WRITE FORTRAN RECORO 
COMMON OUTPUT CODE 
OVERLAY LOADING ROJTINE. 
C31PUTL THL SQUARE ROOT OF X. OPT=ALL. 
LINK BETMdLN SY5=A1D AND INITIALIZATION C03E. 
MATH LIBRARY LINK TO ERROR MESSAGE PROCESSOR. 
PR3CESS aYSTEM REOJE3T. 
L75086 LOADER USER 3ALL INTERFACE ROUTINE. 



Figure 1-13-6. Loader Map of Main Overlay (0,0) 



1-13-8 



60435400 A 



ENTRY POINTS. 



ENTRY 


AOORESS 


PROGRAM 


REFERENCES 












OUTPUT? 


220* 


TESTA 


PRNT 


*503 










TRY 


**26 


TRY 


TESTA 


*26«» 










TRI 


**36 




TESTA 


4270 










PRNT 


M»67 


PRYT 


TESTA 


*256 


*306 








Q8NTRY. 


*5*1 


FDRSYS= 


TESTA 


*252 










FECCHR. 


1*717 


03110= 


KOOER* 


6653 


671*9 








FECPRT. 


1*737 




FMTAP= 


5575 










FEOFAL. 


*775 


FLTOUT= 


KODER= 


7035 


7054 


7075 






FEOEOV. 


5017 




KODERs 


705* 










FEOEXP. 


5021 




<ODER= 


7036 










FEORND. 


5056 




KOOER= 


7023 


7051 


7072 






FEOSCA. 


5113 




KODER= 


7013 


7046 


7066 






FEOZRO. 


5177 




KOOER= 


702* 


7052 


7073 






FECNAP. 


5316 


F1TAP= 


KOOER= 


6660 


6735 


67*1 


6761 


6776 


FECAP. 


532* 




OUTC= 


7360 










FECFMT. 


53«»3 




KOOER= 


6655 


7201 


7203 


7213 


72*3 


FECFMU. 


53*6 




KOOER= 


661* 


672 








FECJP= 


5*51 




OUTC= 


7353 










FECLP. 


5*52 




KODER= 


66*7 










FECRP. 


5*75 




KODER= 


6650 










FECEE. 


5512 




KODER= 


7001 










FECV. 


5560 




KOOER= 


662* 










FECBUG. 


5567 




KODER= 


6575 


6576 








ENO. 


5715 


FORSYS= 


TESTA 


*311 










IOERR. 


6012 




OUTC= 


7*33 










SYSERR. 


611* 




COMIO= 

FMTAP= 

GETFIT= 

OUTC= 

OVERLAY 


*756 
561* 
6562 
7**0 
7730 


*771 








FECOPE. 


6*06 




OUTC= 


7335 










LINLIN. 


6*51 




OUTC= 


7*17 










OBGFIT. 


6*76 




OVERLAY 


7662 










GETFIT. 


6536 


GETFIT= 


OUTC= 


7277 










KOJPT. 


6576 


K03ER= 


OUTC= 


7267 










KODWRT= 


7237 




OUTC= 


73*7 










KOREP. 


72** 




OUTC= 


7270 










OUTCI. 


7271 


OUTC= 


PRNT 


*501 










FEOL. 


7**6 


OJTCOM= 


KOOER= 


6613 


6656 








FEOI. 


7*51 




KOOERs 


6610 


6611 








FEOXFL. 


7516 




FLTOUT* 
KQDER* 


5 021 

rtrr 


5210 
71*6 








FEOAFH. 


752* 




FLTOUT» 


50** 


50*7 


5051 


5055 


S2B* 


FEOBLS. 


7531 




FLTOUT= 
KOOER= 


5000 
5203 
7030 


5001 
7155 


5002 


501* 


517* 


FEOCNV. 


75** 




FLTOUT= 


5016 










FEOR1F. 


7575 




FLTOUT= 


5172 










OVERLAY 


7623 


OVERLAY 


TESTA 


*25* 


*30* 








SQRT. 


1000* 


SORT 


TRY 


**31 


**33 


***7 


**51 




3YSAID= 


10027 


SYSAID= 


Q8.IO. 
SYS=1ST 


*5*0 
100*7 










SYS1ST. 


10033 


SYS=1ST 


SORT 


10017 










SYS» 


I 1011* 


SYS.RM | 


0.8.10. 
FORSTS= 

ERR.Rrt 


*536 

5701 

11067 


*5*6 

5733 

11106 


5772 
11237 






MSG= 


101<»3 




0.8. 10. 


*5*«» 
















FORSrS= 


5726 

6314 


5731 


5761 


576 3 


5770 








ERR.R1 


1102* 


110*4 


11115 












put.su 


13262 


13316 














LXER.5Q 


16355 










LOAOER 


10162 


UDLOAD 


OVERLAY 


770* 










LBUF.SQ 


10i»51 


LBUF.SQ 


LXER.SQ 


163** 










RN.CIO 


10613 


CIO.RH 


ERR.RH 

OPEN.SQ 

OPEX.SQ 


11103 
12275 
12*37 


12410 














PUT.SH 


12600 
1*020 


13223 


13310 


13330 


135*1 








MAR. S3 


1*132 


1*306 














CLSF.SQ 


1**0* 


1**71 














CLSV.SQ 


1*535 


1*5<»5 


14561 


1*571 


1*603 








GET. S3 


1510* 


15271 


1536* 


15521 


15533 








MEOX.SQ 


16532 


16552 









7236 72*5 



5175 5201 



6267 6306 



13551 1363* 



Figure 1-13-6. Loader Map of Main Overlay (0,0) (Contd) 



60435400 A 



1-13-9 



RM.RCLA 


10623 




ERR.RM 

PUT.SQ 

MAR.SQ 

CLSF.SQ 

GET.SQ 

BTRT.SQ 


11073 
13522 
14232 
14372 
14752 
16210 


13657 
15026 


14007 










RN.RCLP 


10630 




PUT.SQ 
GET.SQ 


13236 
15245 


13256 












ERR.RM 


10734 


ERR.RM 


JMPS.RM 
MEMC.RM 
OPES.FO 


10441 
11610 
11613 


10442 
11611 


10443 
11612 


10444 


10445 


10446 


10450 








OPEN.FO 


11614 


11615 


11616 


11617 


11620 


11621 


11622 








OPEN.RM 


11625 

12050 


11716 
12051 


11765 


12031 


12040 


12042 


12046 








OSUB.RM 


12140 
12147 


12141 
12150. 


12142 


12143 


12144 


12145 


12146 








OPEN.SQ 


12226 
12423 


12230 
12424 


12233 


12274 


12334 


12336 


12373 








OPEX.SQ 


12433 




















RLEQ.RM 


12462 




















PUT.FO 


12522 


12523 


12524 


12525 


12526 


12527 


12530 








PUT.SQ 


12531 


12536 


12572 


12613 


12616 


1262.3 


12672 










12734 


12770 


13017 


13225 


13254 


13255 


13275 










14015 


14023 


















CLSF.FO 


14310 


14311 


14312 


14313 


14314 


14315 


14316 








CLSF.RM 


14321 


14332 


14340 
















CLSF.SQ 


14350 


14427 


14472 
















CLSV.PO 


14473 


14474 


14475 


14476 


14477 


14500 


14501 








GET.F3 


14625 


14626 


14627 


1463 


14631 


14632 


14633 








GET.SQ 


14652 
15562 


14656 
15605 


14673 


14700 


14705 


15405 


15527 








LXER.SQ 


16371 




















MEOX.SQ 


16454 


16464 


16467 


1650 














SKFL.FO 


16610 


16611 


16612 


16613 


16614 


16615 


16616 








SKFL.SQ 


16621 


16624 


16627 










HOVE.RM 


11262 


MOVE.RM 


PUT.SQ 
FSU.SQ 


13111 
16061 














CHHR.SQ 


11346 


CH4R.SQ 


OPEN.SQ 
PUT.SQ 


12162 
13026 














MCT.RM 


11362 


M3T.RM 


OPEN.RM 
CLSF.RM 


11646 
14324 


11650 


11752 


11754 


12022 


12026 




OPEN.RH 


11623 


0?EN.RH 


FORSYS= 


6447 














OSUB.RM 


12057 


OSUB.RM 


OPEN.RM 


11766 














OPEN.SQ 


12152 


OPEN.SQ 


FORSYS= 


6447 














OPXX.SQ 


12267 




OPEX.SQ 


12445 














OPEX.SQ 


12432 


OPEX.SQ 


OPEN.SQ 


12266 














RLEQ.RM 


12457 


RLEQ.RM 


PUT.SQ 
MAR.SQ 


12644 
14031 


12726 












PUT.SQ 


12532 


PJT.SQ 


F0RSYS= 
OUTC= 


6331 
7423 














MAR.SQ 


14030 


MAR.SQ 


PUT.SQ 
MEOX.SQ 


12622 
16477 














CLSF.RH 


14317 


CLSF.RH 


FORSYS= 
OUTC= 


6101 
7327 


6140 












RSPT.SQ 


14430 


CLSF.SQ 


OPEN.SQ 
OPEX.SQ 
CLSV.SQ 
GET.SQ 


12345 
12434 

14521 
15027 


14615 
15513 












CLSV.SQ 


14504 


CLSV.SQ 


PUT.SQ 
GET.SQ 


13300 
15622 


13532 












SKGT.SQ 


14722 


GET.SQ 


SKFL.SQ 


16645 


16653 












GXIT.SQ 


15030 




Z.SQ 
FSU.SQ 


15730 
16036 


15765 
16052 


15777 
16075 


16077 








GRTJ.SQ 


15111 




FSU.SQ 


16037 


16102 












ANBL.SQ 


15150 




BTRT.SQ 


16122 


16140 


16145 


16223 








AHAC.SQ 


15154 




FSU.SQ 


16040 


16102 


16107 
















BTRT.SQ 


16110 
16167 


16123 
16175 


16147 
16200 


16150 
16206 


16157 


16160 


16161 


OXIT.SQ 


15654 




SKFL.SQ 


16635 














GET.Z 


15701 


Z.5Q 


FORSYS* 


6074 














RMUO.SQ 


16021 


FSU.SQ 


GET.SQ 


15022 














RMU2.SQ 


16041 




GET.SQ 


15016 














PUT.C 


16110 


BTRT.SQ 


Q9.IO. 


4514 














LAB1.SQ 


16231 


LXER.SQ 


Q8.IO. 


4514 














MEOS.SQ 


16451 


MEOX.SQ 


OVERLAY 


7672 














SKFL.SQ 


16617 


SKrL.SQ 


FORSYS= 


6074 















Figure 1-13-6. Loader Map of Main Overlay (0, 0) (Contd) 



1-13-10 



60435400 A 



LOAD MAP - TESTA 
3VERLAYOVLA,1,01 



CYBER LOADER i.O-U^Ol 



75/05/22. 12.53.58. 



PAGE 



OVERLAY(OVLA,1,0) 

FWA OF THE LOAD 17033 

LWA*1 OF THE LOAO 17103 

TRANSFER AODRESS — OVLIO 



17036 



ENTRY POINTS. 










ENTRY 


ADDRESS 


PROGRAM 


REFERENCES 




OUTPUTS 
Q.8NTRY. 
END. 
OUTCI. 


220«f 

5715 
7271 


TESTA 
FO*SYS= 

ourc= 


OVLIO 
OVLIO 
OVLIO 
OVLIO 


17052 
17036 
17051 
170<»0 



17056 



170^2 



17062 



170UV 



17066 



170*»d 



17072 
17050 



Figure 1-13-7.. Loader Map of Primary Overlay (1,0) 



1.0000000 


2.0000000 


3.00 00000 


<♦. 0000000 


5.0000000 


6.0000000 


7.0000000 


8.0000000 


9.0000000 


10.0000000 


10O. 0000000 


200.0000000 


300.0000000 


i»00. 0000000 


500.0000000 


600.0000000 


700.0000000 


800.0000000 


900.0000000 


1000.0000000 


101.0000000 


2.1000000 


3.1000000 


202.0000000 


2.2000000 


3.2000000 


303.0000000 


2. 3000000 
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6177.2000000 


0.0000000 


0.00 00000 


0.0000000 


0.0000000 


0. 0000000 




2.0000000 


<4.0000000 


6.0000000 


B. 3000000 


10.0000000 


12.0000000 


l<t. 0000000 


16.0000000 


18.0000000 


20.0000000 


2.5284271 


<t. 0000000 


t*. 8989795 


5.6S685<*2 


6.32«t5553 


6.92320 32 


7.U8331'+3 


8.3000000 
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101. 0000000 


2.1000000 


3.1000000 


202.0000000 


2.2000000 


3.2000000 


303.0000000 


2.3000000 


3.3000000 














795.7«*98875 


0.0000000 


0.0000000 


0.0000000 


0.0000000 


0.0000000 




1.0000000 


2.0000000 
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if. 0000000 


5. 0000000 


6.0000000 


7. 0000000 


8.0000000 


9.0000000 


10.0000000 


100.0000000 


200.0000000 


300.0000000 


(♦00. 0000000 


500.0000000 


600.0000000 


700. 0001000 


800.3000000 


900. 0000000 


1000.0000000 


101.0000000 


2.1000000 


3.10000 00 


202.0009000 


2.2000000 


3.2000000 


303.0000000 


2.3000000 


3.30000 00 














6177.2000000 


0.0000000 


0. 0000000 


0.0000000 


0.0000000 


0.0000000 




2.0000000 


'♦.0000000 


6.0000000 


8.3000000 


10.0000000 


12.0000000 


lit. 0000000 


16.0000000 


18.00000 00 


20.0000000 


2.328U271 


<*. 0000000 


W, 898 9795 


S.63685^2 


6.32i»5553 


6.92820 32 


7.«*8331^8 


8.3000000 


8. '♦85281'* 


S.9^2719 


101. 0000000 


2.1000000 


3.10000 00 


202.0000000 


2.2000000 


3.2000000 


303.0000000 


2.3000000 
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Figure 1-13-8. Program Output 



60435400 A 



1-13-11 



EXCHANGE PACKAGE. 
P 1 1011'* I A0 
RA 152500 Al 
FL 17200 A2 

7 





EH 

RAX 

Fix 

1A 



XO 
XI 
X2 
X3 
Xi» 
X5 
X6 
X7 

(RA) 
(RA+11 



A3 
A4 
A5 

1400 A6 
A7 



2204 


BO 





(AO) 


1725 2420 


1 


Bl 


1 


(Al) 


0516 0420 


6530 


B2 


7 77755 


(A2) 


1717 0631 


6531 


B3 


245 


(A3) 


2000 0000 


5670 


B4 


24 


(Am 


5555 5555 


567V 


B5 


low** 


(A5) 


2000 0000 


1 


86 


610 2 


(A6) 


0516 0420 


2236 


B7 


30 


(A7) 


0000 0000 



0000 0000 
0000 0000 
1717 0631 
2000 0000 
2000 0000 
0000 0000 
0516 0420 
2000 0000 



SOOO 0000 0000 
0000 0000 0000 
1*631 4640 3615 
0000 0000 0012 
0000 0000 0000 
0000 0000 0003 
0000 0000 0000 
0000 0000 0001 



0000 0000 0000 0000 0000 
0516 0420 0000 0000 0000 



25J4 0000 0000 

0000 0000 0000 

4631 4640 3615 

0010 0000 0012 

5555 5733 3637 

0000 0003 1561 

0000 0000 0000 

0000 0000 0000 



DUMP FROM 
10 054 
10060 
10054 
10070 
10071* 
10100 
10104 
10110 
10111* 
10120 
10124 
10130 
1013<* 
1011*0 
101<» l» 
10150 
10151* 



1005** r 
62577 
10633 
01000 
21322 
00000 
55012 
00000 
OOOOO 
01*000 
51100 
51100 
51100 
71602 
01*000 
20622 
<>3652 
73220 



10154 
77676 
5531*1 
00000 
5301*0 
OOOOO 
20725 
00000 
00000 
0573«* 
10112 
00001 
00001 
20311* 
10132 
12161 
71100 
01000 



66622 
22704 
61000 
01*000 
OOOOO 
15051 
00000 
00000 
00000 
01*000 
01000 
03110 
20652 
61000 
20651 
00*00 2 
10111* 



531*55 

5 51*31 
1*6000 
10030 
OOOOO 

6 21*55 
00000 
00000 
0000 
10122 
10112 
10127 
36662 
1*6000 
2 0123 
12661 
1*6000 



06600 


10056 


51*355 


551*31 


76166 


51600 


10103 


55761 


51300 


10076 


61100 


00001 


00000 


OOOOO 


00000 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


11160 


1*0506 


11161 


121*05 


00009 


00000 


00000 


30000 


00000 


00000 


00000 


00000 


51100 


00001 


03110 


10115 


71100 


00130 


20160 


1*6000 


20652 


01000 


10111* 


1*6000 


71502 


20311* 


01*000 


10125 


53160 


20173 


03310 


10133 


71603 


21*616 


12661 


J0651 


03260 


1011*1 


71600 


00301 


53130 


11161 


71600 


31117 


01*001* 


10155 


61000 


i*600fl 



031*10 


10057 


56330 


561*31 


10633 


71*260 


22701* 


55671 


1*3002 


55231 


26050 


53735 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


01*000 


10125 


OOOOO 


OOOOO 


51*610 


01*000 


10113 


1*6000 


13661 


13161 


13661 


1*6000 


51100 


00001 


03110 


10126 


20150 


36661 


01000 


10111* 


03010 


10133 


51100 


00001 


01000 


10111* 


61000 


1*6000 


2061*5 


13116 


01*000 


1011*1 


03270 


10153 


14777 


27606 


53120 


20173 


03310 


10150 



03610 


10060 


56330 


571,31 


21111 


55761 


S5071 


1*6000 


21322 


55121 


63635 


55411 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


11160 


61116 


112i»0 


50000 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


10071* 


01300 


OOOOO 


OOOOO 


OOOOO 


51100 


00066 


03310 


10121 


51600 


10113 


10611 


1*6000 


01*001* 


10127 


61000 


<*6000 


Oi*00i* 


10133 


61000 


1*6000 


03110 


10135 


71100 


00001 


04000 


05732 


OOOOO 


OOOOO 


01000 


10133 


61000 


1*6000 


12717 


20652 


53720 


12662 


03110 


10147 


52120 


00001 



Figure 1-13-9* Exchange Package Dump 



DUMP FROH . TO 10000 

D OOOOO OOOOO OOOOO OOOOO 05160 

1* OOOOO 10000 OOOOO OOOOO OOOOO 

DUPLICATED LINES. 

51* 56110 03110 00054 54710 51100 

60 15051 52000 OOOOO 0061 OOOOO 

64 17261 40100 OOOOO OOOOO 40000 

70 17261 40157 55000 OOOOO OOOOO 

74 OOOOO OOOOO OOOOO OOOOO OOOOO 

100 OOOOO 0OO01 7103O 04252/AAA(A)17214 

104 17234 OOOOO OOOOO OOOOO 17235 

110 17244 OOOOO OOOOO OOOOO 17244 

114 17224 OOOOO 00000.0 0000 17224 

120 17226 73317 27205 41145 17227 

124 17234 36156 74671 37646 (C) 17226 

130 17276 24000 OOOOO OOOOO 17214 

134 17214 46314 63146 31463 17216 

1<*0 17244*40000 00000 00000 17246 

144 OOOOO OOOOO OOOOO 0166 OOOOO 

150 OOOOO 00002 OOOOO 00203 OOOOO 

154 OOOOO OOOOO OOOOO OOOOO OOOOO 

DUPLICATED LINES. 

2204 17252 42025 24000 OOOOO OOOOO 

2210 OOOOO POOOO OOOOO 06103 OOOOO 

2214 OOOOO OOOOO OOOOO OOOOO OOOOO 

2220 OOOOO 10000 OOOOO OOOOO 00300 

2224 OOOOO OOOOO 08002 24400 OOOOO 

2230 04111 46000 00040 02244 OOOOO 

2234 OOOOO OOOOO OOOOO OOOOO OOOOO 

2240 OOOOO OOOOO OOOOO OOOOO OOOOO 

2244 55555 55555 55555 55534 57333 

2250 55555 53657 33333 3 3333 33335 

2254 33333 33333 33555 5 5555 55555 

2260 OOOOO OOOOO OOOOO OOOOO 55555 

2264 33333 33333 55555 55555 55553 

2270 55555 55555 35333 35733 33333 

2274 33335 73333 33333 33333 OOOOO 

.2300 55555 55541 33335 73333 33333 

2304 33573 33333 33333 33355 55555 

2310 33333 35555 55555 55534 33345 

2314 573 43 33333 33333 35555 55555 

2320 33335 55555 55555 5 5553 35573 

2324 55553 63336 57333 33333 33333 

2330 55555 55555 55555 55555 55553 

2334 57353 33333 33333 3 5555 55555 

2340 33335 55555 55555 55555 33573 

2344 55555 55533 57333 3 3333 33333 

2350 55555 55555 55375 73333 33333 

2354 43573 33333 33333 33355 55555 



42000 OOOOO OOOOO 
OOOOO OOOOO 30000 



11162 02524 OOOOO 00143 
OOOOO OOOOO OOOOO OOOOO 



17252 42025 24000 02204 
OOOOO OOOOO OOOOO OOOOO. 



00001 
17200 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
40000 
71421 
3S735 
OOOOO 
31463 
46314 
OOOOO 
00042 
OOOOO 
OOOOO 

14700 
00003 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
02237 
OOOOO 
33333 
55555 
55541 
555E5 
43357 
33333 
OOOOO 
33333 
55555 
73333 
55555 
53333 
35555 
65736 
55555 
33333 
30000 
33333 
55555 



03110 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
60500 
20426 
OOOOO 
14631 
63146 
OOOOO 
60000 
01400 
OOOOO 

40630 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
33333 
55555 
57333 
55555 
33333 
33555 
OOOOO 
55555 
44333 
33333 
55365 
33333 
55555 
33333 
55335 
33333 
OOOOO 
55555 
55343 



00055 
00001 n 
17103 3 
30000 « 
OOOOO ^ 
OOOOO <i 



OOOOO 



* 



a 



ooooo 

44411 O 

1*0772 rf 

OOOOO 

46315 

31463 

OOOOO 

OOOOO 

OOOOO 

OOOOO 

2227 
2244 
OOOOO 
2244 
OOOOO 
2244 
OOOOO 
OOOOO 
35555 
35555 
33333 
35543 
3 3333 
55555 
OOOOO 
55555 
35733 
33333 
73433 
33355 
55555 
33333 
73333 
33355 
OOOOO 
55555 
35733 



64550 
OOOOO 
40242 
OOOOO 
OOOOO 
17224 
17236 
17245 
17225 
17234 
17214 
17216 
-17226 
17247 
OOOOO 
OOOOO 
OOOOO 

OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
55555 
37573 
33333 
57333 
33335 
55553 
55555 
55423 
33333 
OOOOO 
33333 
55555 
55355 
33000 
33333 
55555 
55555 
55555 
33333 



02550 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
52023 
OOOOO 
14631 
31463 
OOOOO 
40000 
OOOOO 
OOOOO 
OOOOO 

00042 
22600 
00002 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
55555 
33333 
35555- 
33333 
55555 
63333 
55555 
33357 
33333 
OOOOO 
33333 
55555 
73633 
OOOOO 
33333 
55555 
55555 
54157 
33333 



OOOOO 
OOOOO 
01000 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
53147 
OOOOO 
46314 
14631 
OOOOO 
OOOOO 
20010 
OOOOO 
OOOOO 

60010 
03400 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
55355 
33333 
55555 
33333 
55555 
57333 
55554 
33333 
33555 
OOOOO 
55555 
55553 
33333 
OOOOO 
55555 
55553 
55555 
33333 
33555 



46000 
OOOOO 
17032 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
74736 
OOOOO 
63146 
46315 
OOOOO 
OOOOO 
OOOOO 
OOOOO 
OOOOO 

OOOOO 
04521 
OOOOO 
OOOOO 
OOOOO 
02244 
OOOOO 
OOOOO 
73333 
33355 
55555 
35555 
53433 
33333 
03333 
33333 
55555 
OOOOO 
55555 
65735 
33333 
OOOOO 
55555 
35733 
55535 
33333 
55555 



(B) 



OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


40000 


OOOOO 


40000 


ooooo 


OOOOO 


OOOOO 


OOOOO 


00090 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


17226 


OOOOO 


OOOOO 


OOOOO 


17237 


OOOOO 


OOOOO 


OOOOO 


17215 


52023 


63147 


74736 


17226 


24613 


01655 


51333 


17234 


17416 


66315 


75547 


17216 


14631 


46314 


63146 


17304 


57000 


OOOOO 


OOOOO 


17236 


OOOOO 


OOOOO 


OOOOO 


11162 


02524 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


20010 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


00002 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


02244 


17252 


42025 


24000 


00131 


37260 


OOOOO 


01000 


04245 


OOOOO 


OOOOO 


OOOOO 


00001 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


33333 


33333 


55555 


55555 


55555 


55555 


55554 


05733 


55425 


73333 


33333 


33333 


55555 


55555 


55445 


73333 


33573 


33333 


33333 


33355 


33333 


35555 


55555 


55537 


57333 


33333 


33333 


35555 


33335 


55555 


55555 


54333 


55343 


33333 


57333 


33333 


55555 


55555 


55555 


55535 


55353 


33557 


33333 


33333 


33333 


33333 


33555 


55555 


OOOOO 


BOO 00 


SOOOO 


OOOOO 


55555 


55555 


55413 


44242 


55555 


53357 


33333 


33333 


33333 


33333 


33555 


55555 


57333 


33333 


33333 


35555 


33335 


55555 


55555 


55555 


55555 


53435 


57333 


33333 



Figure 1-13-10.. Central Memory Dump 



1-13-12 



60435400 A 



2350 33333 35555 55555 

2364 57333 33333 33333 

2370 33335 55555 55555 

2371* 55555 55537 57434 

2400 55555 55555 55555 

2404 55555 54257 37433 

2410 43403 54334 37555 

2414 00000 00000 00000 

2420 33333 33333 55555 

2424 55555 55555 55553 

2430 55355 73633 33333 

2434 33000 00000 00000 

2449 33333 33333 55555 

2444 55555 55555 55553 

£450. OOQOO 80000 00000 

DUPLICATED LINES. 

4244 00000 00000 00000 

"♦259 -24052 321*01 55550 

4254 01000 07623 00160 

4260 51500 04332 52450 

4264 01000 04426 00220 

4270 01000 04436 00230 

4274 71700 00001 51700 

4300 61550 00002 24700 

4304 01000 07623 00260 

4310 27005 2i»700 51700 

4314 00000 00000 00000 

4320 00000 00000 00000 

432<* 00000 00000 00000 

4330 00000 00000 00000 

4334 00000 00000 OOOOO 

DUPLICATED LINES. 

*«414 00000 00000 00000 

^420 17261 40155 55555 

4424 51<*00 04456 10644 

4430 46000 1*6000 46000 

4434 51500 04454 30056 

4440 51600 04430 04000 

4444 51700 04426 61000 

4450 50500 00001 53150 

4i*5t* 17224 36156 74671 

4460 OOOOO OOOOO OOOOO 

4464 20221 62455 55550 

4470 74600 54010 51600 

4474 637 5A 46000 46000 

4500 51700 04513 51100 

4504 OOOOO OOOOO OOOOO 

4510 55404 05555 55000 

4514 OOOOO OOOOO OOOOO 

4520 OOOOO OOOOO OOOOO 

4524 33333 33333 55555 

4530 55555 55555 55553 

4534 55355 73633 33333 

4540 OOOOO OOOOO OOOOO 

4544 OOOOO OOOOO OOOOO 

4550 OOOOO OOOOO OOOOO 

4554 OOOOO OOOOO OOOOO 

4560 11701 54335 06020 

4564 20120 01)001 0100 

4570 OOOOO OOOOO OOOOO 

45/4 20120 OOOOO OOOOO 

4600 10255 52510 00005 

4604 71600 00006 43771 

4610 15667 11775 36667 

4614 54650 52510 00006 

4620 71400 04521 61000 

4624 03350 04532 14155 

4630 22227 36727 20603 

4634 66357 04400 04637 

4640 OOOOO OOOOO 61000 

4644 04000 04632 61000 

4650 55555 55555 55555 

4654 77777 77777 77770 

4660 77777 70000 OOOOO 

4664 17204 OOOOO OOOOO 

4670 17354 70400 OOOOO 

i*674 17525 75360 40000 

4700 17677 21522 45040 

*T!9k< 2006* 34157 M576 



5 5555 


34375 


73333 


33333 


33333 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


55555 


55555 


55555 


53441 


35555 


55555 


55555 


34435 


73333 


33333 


33333 


55555 


55555 


55553 


53357 


33333 


33333 


55555 


35574 


33543 


37354 


23455 


55555 


55555 


55553 


75733 


33333 


33333 


33555 


55555 


4 4344 


42444 


05555 


55555 


55555 


55405 


74140 


41434 


03735 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


5 5541 


57363 


53740 


40 40 3 


55555 


55555 


55555 


55415 


74435 


43353 


33635 


55555 


55555 


63634 


37435 


55555 


55555 


55555 


43573 


33333 


33333 


33355 


55555 


55555 


55554 


35737 


5 5555 


55555 


55543 


57443 


73735 


42344 


45555 


55555 


55534 


33345 


73333 


33333 


33333 


OOOOO 


55555 


55555 


55555 


55535 


57343 


33333 


33333 


35555 


55555 


55555 


55365 


73433 


55555 


55353 


33557 


33333 


33333 


33335 


55555 


55555 


55555 


35573 


53333 


33333 


33355 


65735 


33333 


33333 


33555 


55555 


55553 


63336 


57333 


33333 


33333 


35555 


55555 


55555 


3 3333 


oooon 


OOOOO 


OOOOO 


OOOOO 


55555 


55555 


55555 


55555 


55553 


65736 


33333 


33333 


OOOOO 


55555 


55555 


55554 


24440 


57423 


74443 


43424 


5555 


55555 


55555 


55335 


73333 


5 5555 


55555 


53 357 


33333 


33333 


33335 


55555 


55555 


55555 


33573 


33333 


33333 


33355 


3 5733 


33333 


33333 


33555 


55555 


55555 
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57333 
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39000 


OOOOO 


OOOOO 


OOJJOJL 


OOOOO 


00900 
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22600 
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94521 
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22600 
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04521 


77777 


77777 


77777 


66167 


04252 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


51100 


04245 


01000 


04541 


51100 


04312 


46000 


46000 


4250 


51100 


04316 


45000 


46000 


01000 


4467 


00170 


04250 


71700 


00001 


51700 


04332 


00100 


72750 


00100 


40 644 


46000 


51700 


04320 


51700 


04321 


54640 


51100 


04320 


46000 


04250 


515 00 


04332 


72750 


00100 


52650 


00100 


51700 


04320 


51700 


04321 


51100 


04320 


4250 


51500 


04332 


72750 


00001 


72077 


77764 


52650 


00112 


54750 


03300 


04260 


46000 


4333 


51500 


04333 


61600 


00O05 


36055 


63750 


62500 


00100 


51570 


00100 


56450 


30045 


46000 


51770 


00135 


61770 


00001 


06670 


04277 


76770 


46000 


51700 


04333 


51100 


04323 


04250 


51100 


04316 


46000 


46000 


01000 


04467 


00270 


04250 


51500 


04333 


51100 


04250 


0125 


04000 


05715 


46000 


46000 


OOOOO 


OOOOO 


OOOOO 


04416 


OOOOO 


OOQOO 


OOOOO 


04327 


4330 


OOOOO 


ooopo 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


04331 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


00112 


OOOOO 


OOOOO 


OOOOO 


00112 


OOOOO 


OOOOO 


OOOOO 
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Figure 1-13-10.. Central Memory Dump (Contd) 
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SYSTEM UTILITY CONTROL STATEMENTS 14 



NOS provides the following utilities for file maintenance. 

EDIT Performs data manipulations on a specified mass storage file 

MODIFY Edits a Modify -formatted program library file 

OPLEDIT Removes modification decks and identifiers from a Modify -for- 

matted program library file 

UPDATE Edits an Update -formatted program library file 

UPMOD Converts an Update -formatted program library file to a Modify- 

formatted program library file 

KRONREF Generates a cross-reference listing of system symbols 

EDIT STATEMENT 

The EDIT control statement calls the Text Editor utility. The Text Editor enables a 
user to manipulate data on a specified mass storage file through use of special input 
directives called edit commands. For a detailed description of the Text Editor and 
an explanation of these commands, refer to the Text Editor Reference Manual. 

The control statement format is: 

EDITdfhj, m, lfn 2 , lftig) 

or 

EDIT(FN=lfn 1# M=m, I=lfn 2 , L=lfn 3 ) 

lfn. Name of file to be edited (referred to as edit file). This specifi- 

cation is required for batch origin jobs. 

m Mode of file processing: 

ASCII or AS ASCII mode edit file 

NORMAL or N NORMAL mode edit file 

lfrig File from which directives (edit commands) are to be read. 

If omitted, INPUT is assumed. 

lfn 3 File to which output is to be written. If omitted, OUTPUT is 

assumed. 
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MODIFY STATEMENT 

The MODIFY control statement edits a Modify-formatted program library file. 
The control statement format is: 
MODIFY ( Pl ,p 2 ,....p n ) 

p. Any of the following in any order: 

I Use directive input from file INPUT. If the 

I option is omitted, file INPUT is assumed. 

I=lfn.. Use directive input from file lfn... 

1=0 Use no directive input. 

P Use file OPL for the old program library. 

If the P option is omitted, file OPL is 
assumed. 

P=lfn 2 Use file lfn 2 for the old program library. 

P=0 Use no old program library 

C Write compile output to file COMPILE. If 

the C option is omitted, file COMPILE is 
assumed. 

C=lfn3 Write compile output to file Un%. 

C = Write no compile output. 

N Write new program library on file NPL. 

N=lfn. Write new program on file lfn^. 

N=0 Write no new program library. If this option 

is omitted, N=0 is assumed. 

S Write source output on file SOURCE. 

S=lfri5 Write source output on file lfn^. 

S=0 Write no source output. If this option is 

omitted, S=0 is assumed. 

L List output on file OUTPUT. If the L option 

is omitted, file OUTPUT is assumed. 

L=lfn fi List output on file lfn0. 

L=0 List no output. 

LO Select list options: ECTMWDS 

LO=chars Select up to seven list options which can 
be any of the following. 

E Errors 

C Directives other than INSERT, 

DELETE, RESTORE 

T Input text 

M Modifications made 

W Compile file directives 

D Deck status 

S Statistics 

I Inactive statements 

A Active statements 
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A Write compressed compile file. 

D Ignore errors. 

F Modify all decks. 

U Modify only decks mentioned on DECK 

directives; F overrides the U option. 

NR Do not rewind the compile file. 

X Rewind input and output files, set A option, 

and call the COMPASS assembler when 
modification is complete. 

X=prog Rewind input and output files, set A option, 

and call the processing program prog when 
modification is complete. 

X=0 Do not call another processing program. If 

this option is omitted, X=0 is assumed. 

Q Rewind the output file, set A option, and call 

the COMPASS assembler when modification 
is complete. 

Q=prog Rewind the output file, set A option, and 

call the prog assembler when modification 
is complete. 

Q=0 Do not call another processing program. If 

this option is omitted, Q=0 is assumed. 

Z if this parameter is present, the MODIFY 

control card contains the input directives 
following the terminator. When this param- 
eter is specified, the I parameter is ignored. 



| NOTE | 

Do not place another terminator 
after the directives. 

CV=63 Convert 64 -character set OPL to 63-char- 

acter set OPL. 

CV=64 Convert 63-character set OPL to 64-char- 

acter set OPL. 
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The following parameters can be entered only if the X or. 
Q options is selected. 

CB Set assembler argument B=LGO. If the CB. 

option is omitted, B=LGO is assumed. 

CB=lfnY Set assembler argument B^fny. 

CB=0 Set assembler argument B=0. 

CL Set assembler argument L=OUTPUT. 

CL=lfns Set assembler argument L=lfti3. 

CL=0 Set assembler argument L=0. If this option 

is omitted, L=0 is assumed. 

CS Set assembler argument S=SYSTEXT. If the 

CS option is omitted, S=SYSTEXT is assumed. 

CS=lfng Set assembler argument S=lfng. | 

CS=0 Set assembler argument S=0. 

CG Set assembler argument G=SYSTEXT. 

CG=lfn 10 Set assembler argument G=lfn 1Q . t t 

CG=0 Set assembler argument G=0. If this option 

is omitted, CG is defined by the CS option. 

For a more detailed description of Modify, refer to the Modify Reference Manual. 

OPLEDIT STATEMENT 

The OPLEDIT control statement removes modification decks and identifiers from a Modify- 
formatted program library file. 

The control statement format is: 

OPLEDIT( Pl ,p 2 , ...,p n ) 

Pj Any of the following in any order: 

I Use directive input from file INPUT. If the 

I option is omitted, file INPUT is assumed. 

I=lfn* Use directive input from file lfn«. 

1=0 Use no directive input. 

P Use file OPL for the old program library. 

If the P option is omitted, file OPL is 
assumed. 

P=lfn2 Use file lfn 2 for the old program library. 

P=0 Use no old program library. 

N Write new program library on file NPL. 

N=lfn3 Write new program library on file lf^. 

N=0 Write no new program library. If this option 



is omitted, N=0 is assumed. 



| The desired file is retrieved from the system, 
"ft The desired file is a local file. 

1-14-4 60435400 B 



L List output on file OUTPUT. If the L option 

is omitted, file OUTPUT is assumed. 

L=lfn^ List output on file lfn^. 

L=0 List no output. 

M=lfn 5 Write output from *PULLMOD directives on 

file lfn 5 . If this option is omitted, M=MOD SETS 
is assumed. 

LO s x Set list options x; each bit in x, if set, 

turns on the corresponding option. 

001 Errors 

002 Directives 

004 All other input statements 

010 Modifications made 

020 Directives processed from the 

program library 

040 Deck status 

100 Directory lists 

200 Inactive statements 

400 Active statements 

If this option is omitted, x=177 is assumed 
(that is, the first seven options listed). 

F Modify all decks. 

D Debug; ignore errors. 

U Generate *ED IT directives for all decks. 

U=0 Generate no *EDIT directives. 

If the U option is omitted, generate *EDIT 
directives for common decks. 

For a complete description of the OPLEDIT utility, refer to the MODIFY Reference 
Manual. 
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UPDATE STATEMENT 

The UPDATE control statement edits an Update -formatted program library file. 

The control statement format is: 

UPDATE(p!,p 2 , ...,P n ) 

Pi Any of the following in any order: 

A Sequential- to- random program library copy 

B Random -to-sequential program library copy 

C Write compile file output on COMPILE. If 

the C option is omitted, file COMPILE is 
assumed. 

C=lfn 1 Write compile file output on lfn... 

C=0 Write no compile output. 

D Compile output has 80 columns for data; if D 

is omitted, compile output has 72 columns 
for data. 

E Update rearranges the directory to reflect the 

actual order of decks on the program library. 
If E is omitted, the old program library 
directory is not edited. 

F Full update; all decks are compiled. If F is 

omitted, corrected decks and those named on 
COMPILE directives are processed. 

G=lfn 2 Output from PULLMOD directives is written 

on lfn 2 . Any rewind option applying to the 
source file also applies to this file. OUTPUT 
is not a valid file for this option. If G is 
omitted, pulled modifications are appended to 
the source file. 

I Input is on file INPUT. If the I option is 

omitted, file INPUT is assumed. 

I=lfno Input comprises next record on lfng. 

K Compile output decks to be written on file 

COMPILE in COMPILE directive sequence. 

K=lfn^ Compile output decks to be written on lfti4 in 

COMPILE directive sequence. If this option 
is omitted, output is determined by the C 
option. 

L=char char is a string that specifies any of the A, 

F, and through 9 list options. If this option 
is omitted, options A, 1, 2, 3, and 4 are 
selected. Any use of suppresses listing. 

M Merge input is on file MERGE. 

M=lfn 5 Merge input is on file lfrir. If M option is 

omitted, there is no merge file. 

N New program library to be written on file 

NEWPL. 
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N=lfng New program library to be written on file 

lfng. If N option is omitted, no new pro- 
gram library is written. 

O List output to be written on OUTPUT. If 

the O option is omitted, OUTPUT is assumed, 

0=lfn7 List output to be written on Unj. If O 

option is omitted, OUTPUT is assumed. 

P Use file OLDPL for the old program library. 

If the P option is omitted, OLDPL is assumed. 

P=lfn fi Use file lfng for the old program library. 

If this option is omitted, OLDPL is 
assumed. 

Q Only decks on COMPILE directives are 

processed. If Q is omitted, corrected 
decks and those named on COMPILE 
directives are processed. 

R No rewinds are issued for the program 

libraries, compile file, or source file. 

R=char Each character in the string char indicates 

a file to be rewound before and after the 
Update run. 

C Compile 

N New program library 

P Old program library and merge 

library 

S Source and PULLMOD 

Files not specified in char are not re- 
wound. If R is omitted, files are 
rewound before and after the Update run. 

S Source output written on file SOURCE. 

S=lfng Source output written on file lfng. If S 

is omitted, Update does not generate a 
source output file unless the source output 
is specified by T. 

T Source output excluding common decks on 

file SOURCE. 

T=lfnio Source output excluding common decks on 

file lfnio. If T is omitted, no source 
output unless source output is specified 
by S. 

U Update execution is not terminated by 

normally fatal errors. If U is omitted, 
Update execution terminates upon en- 
countering a fatal error. 

W The new program library (refer to N 

option) will be a sequential file. If W 
is omitted, the new program library will 
be a random file (unless it is a magnetic 
tape file). 
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X Compile file is in compressed format. If X 

is omitted, the compile file is not in com- 
pressed format. 

Z The input file (refer to I option) is assumed 

to be in PCS-compressed format. This param- 
eter applies to the directives input file only; 
it does not apply to files specified by READ 
directives. If Z is omitted, the input file is 
a normal, coded file. 

8 Compile file output is composed of 80- column 

line images. If this option is omitted, com- 
pile file output is composed of 90-column line 
images. 

*=char The master control character (first character 
of each directive) for this Update run is char 
which can be any character having a display 
code octal value in the range 01 through 54 
except for 51 and 52 (the open and close 
parentheses). If this option is omitted, the 
master control character is *. 

/=char The comment control character for this Update 
run is char which can be A through Z, 
through 9, or +-*/$=. Note, however, that 
the character should not be changed to one of 
the abbreviated forms of directives unless 
NOABBREV is in effect. If this option is 
omitted, the comment control character is 
a slant bar. 

Note that the UPDATE control statement is processed in product set format. For a more 
detailed description of Update, refer to the Update Reference Manual. 
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UPMOD STATEMENT 

The UPMOD control statement converts an Update -formatted program library file to a 
Modify-formatted program library file. 

The control statement format is: 

UPMOD(p r p 2 , . . . , p n ) 

p. Any of the following in any order: 

P Update program library from file OLDPL. 

If the P option is omitted, file OLDPL is 
assumed. 

P=lfn-, Update program library from file lfn^. 

N Modify program library on file OPL. 

N=lfn 2 Modify program library on file lfn 2 . 

M Modify program library name is OPL. If 

the M option is omitted, file OPL is as- 
sumed. 

M=lftig Modify program library name is 1613. 

F Convert to file mark. 

NR Do not rewind file lfn^. 

The Update file must be in sequential format. A random Update file must first be 
changed to sequential format via Update before being submitted to UPMOD for conversion. 
Unless otherwise specified, only one record from the Update file is converted. After 
the Modify OPL has been created, no references should be made to modset identifiers 
present on the Update library. The new OPL should be treated as any other program 
library created by a Modify creation run. 
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KRONREF STATEMENT 

The KRONREF control statement generates a cross-reference listing of system symbols 
used by decks on a MODIFY OPL. 

The control statement format is: 

KRONREF (P=lfn! , L=lfn 2 , S=lfn 3 , G=lfn 4 ) 

P=lfn 1 OPL input from file lfn^. If the P option is omitted or 

P alone is specified, file OPL is assumed. 

L=lfn2 List output on file lfn2.. If the L option is omitted or L 

alone is specified, file OUTPUT is assumed. 

S=lfn 3 System text from overlay lfn3. If the S option is omitted 

or S alone is specified, file SYSTEXT is assumed. 

G=lfn4 System text from local file lfn 4 . If G is omitted, system 

text is acquired as specified or defaulted by the S option. 
If G alone is specified, local file TEXT is used. Use of 
the G option overrides any S specification. 

The names of programs on the OPL are listed for those decks that reference the 
following. 

• PP direct cell locations defined in lfn 3 or lfn 4 

• PP resident entry points defined in lfn 3 

• Monitor functions 

• Central memory pointers (in low core) defined in lfn 3 or lfn^ 

• Central memory locations (in low core) defined in lfn 3 or lfn 4 

• Control point area words defined in lfn 3 or lfn 4 

• Dayfile message options 

• File types and mass storage constants 

• Job origin types, queue types, and priorities 

t 

• Error flags referenced 

• Common deck calls 

• PP packages called 

• Special entry points 
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CHARACTER SETS 



NOS TIME-SHARING 64-CHARACTER SET 



The character sets for ALGOL and COBOL are listed in their respective reference 
manuals. 
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27 


X 


330 


X 


170 


X 


142 


X 


142 


30 


Y 


131 


Y 


371 


Y 


147 


Y 


147 


31 


z 


132 


z 


372 


z 


124 


z 


124 


32 





060 





060 





144 





144 


33 


1 


261 


1 


261 


1 


040 


1 


040 


34 


2 


262 


2 


262 


2 


020 


2 


020 


35 


3 


063 


3 


063 


3 


160 


3 


160 


36 


4 


264 


4 


264 


4 


004 


4 


004 


37 


5 


065 


5 


065 


5 


010 


5 


010 


40 


6 


066 


6 


066 


6 


130 


6 


130 


41 


7 


267 


7 


267 


7 


150 


7 


150 


42 


8 


270 


8 


270 


8 


070 


8 


070 


43 


9 


071 


9 


071 


9 


064 


9 


064 


44 


+ 


053 


+ 


055 


+ 


023 


+ 


067 


45 


- 


055 


- 


275 


- 


067 


- 


067 


46 


* 


252 


* 


120 


* 


070 


* 


013 


47 


/ 


257 


/ 


257 


/ 


007 


/ 


007 


50 


( 


050 


( 


053 


( 


064 


( 


153 


51 


) 


251 


) 


252 


) 


144 


) 


1 II 


52 


$ 


44 


$ 


374 


$ 


004 


.a 


171 


53 


= 


275 


= 


245 


= 


023 


= 


010 


54 



t THE OCTAL CODES LISTED FOR ASCII CODE TERMINALS ARE SHOWN WITH EVEN 

PARITY (NORMAL) 
tt THE OCTAL CODES LISTED FOR CORRESPONDENCE CODE TERMINALS ARE SHOWN 
WITH ODD PARITY (NORMAL) 
ttt USE OF THE COLON IN PROGRAM AND DATA FILES WILL CAUSE PROBLEMS. THIS IS 
PARTICULARLY TRUE WHEN IT IS USED IN PRINT AND FORMAT STATEMENTS. 



60435400 C 



1-A-l 



ASCII CODE TERMINAL 


CORRESPONDENCE 


CODE TERMINAL 


INTERNAL 
DISPLAY CODE 
(6/12-BIT OCTAL) 


STANDARD PRINT 


APL PRINT 


STANDARD PRINT 


APL PRINT 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(7-BIT OCTAL) 


CHAR 


CODE 
(7-BIT OCTAL) 


(SPACE) 


240 


(SPACE) 


240 


(SPACE) 


100 


(SPACE) 


100 


55 


, 


254 


i 


254 


, 


073 


t 


073 


56 


. 


056 




056 


. 


121 


. 


121 


57 


# 


243 


•• 


041 


# 


160 


•• 


040 


60 


C 


333 


C 


273 


Va 


001 


C 


153 


6 1 


] 


335 


] 


072 


Vz 


001 


] 


III 


62 


% 


245 


f 


176 


% 


010 


T 


023 


63 


" 


042 


* 


050 


•• 


1 1 1 


* 


070 


64 





I37t 





306 





067 


_ 


163 


65 


! 


041 


V 


251 


* 


130 


V 


064 


66 


a 


246 


A 


137 


a 


150 


A 


144 


67 


i 


047 


1 


113 


■ 


1 II 


1 


032 


70 


p 


077 


? 


321 


? 


007 


? 


1 33 


71 


< 


074 


< 


243 


NULL 




< 


160 


72 




> 


276 


> 


047 


NULL 




> 


1 50 


73 




® 


300 


< 


044 


@ 


020 


< 


004 


74 


\ 


134 


\ 


077 


NULL 




\ 


007 


75 




/\ 


336 


— 


042 


NULL 




— 


020 


76 




; 


273 


; 


074 


; 


153 


; 


073 


77 


NULL 








134 


NULL 




NULL 




7600 






a 


341 


a 


101 


a 


171 


a 


171 


7601 


b 


342 


1 


102 


b 


166 


1 


166 


7602 


c 


143 


n 


303 


c 


172 


n 


172 


7603 


d 


344 


L 


104 


d 


052 


L 


052 


76 04 


e 


145 


c 


305 


e 


112 


c 


112 


7605 


f 


146 


X 


336 


f 


163 


X 


023 


7606 


g 


347 


V 


107 


g 


043 


V 


043 


7607 


h 


350 


A 


110 


h 


046 


A 


046 


7610 


i 


151 


\ 


311 


i 


03 1 


\ 


031 


76 1 1 


J 


152 





312 


J 


103 





103 


7612 


k 


353 


H 


173 


k 


032 


NULL 




7613 




1 


154 


D 


314 


1 


106 


D 


106 


76 14 


m 


355 


1 


1 15 


m 


141 


1 


141 


76 15 


n 


356 


T 


116 


n 


122 


T 


122 


76 16 





157 





317 





105 





105 


76 17 


P 


360 


- 


100 


P 


013 


- 


001 


7620 


q 


161 


- 


140 


q 


133 


- 


101 


7621 


r 


162 


P 


322 


r 


051 


P 


051 


7622 


s 


363 


r 


123 


s 


045 


r 


045 


7623 


t 


164 


~ 


324 


t 


002 


~ 


002 


76 24 


u 


365 


4 


125 


u 


062 


1 


062 


76 25 


V 


366 


u 


126 


V 


061 


u 


061 


7626 


w 


167 


(it 


327 


w 


165 


w 


165 


7627 


X 


170 


z> 


330 


X 


142 


z> 


142 


76 30 


y 


371 


t 


131 


y 


147 


t 


147 


7631 



t ON TTY MODELS HAVING NO UNDERLINE, THE BACKARROW (-) TAKES ITS PLACE 



l-A-2 



60435400 C 



ASCII CODE TERMINAL 


CORRESPONDENCE CODE 


TERMINAL 


INTERNAL 
DISPLAY CODE 
(6/12-BIT OCTAL) 


STANDARD PRINT 


APL PRINT 


STANDARD PRINT 


APL PRINT 


CHAR. 


CODE 
(8-BIT OCTAL] 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(8-BIT OCTAL) 


Z 


372 


c 


132 


Z 


124 


c 


124 


7632 


\ 


173 


\ 


335 


NULL 




NULL 




7633 








174 


> 


246 


± 


040 


> 


130 


7634 


\ 


175 


} 


175 


NULL 




NULL 




7635 








176 


h 


133 


NULL 




NULL 




7636 






DEL 


377 


DEL 


377 


NULL 




NULL 




7637 






NUL 


OOO 


NUL 


000 


NUL 


075 


NUL 


075 


7640 


SOH 


201 


SOH 


201 


SOA 


166 


SOA 


166 


7641 


STX 


202 


STX 


202 


EOA 


064 


EOA 


064 


7642 


ETX 


003 


ETX 


003 


NULL 




NULL 




7643 






EOT 


204 


EOT 


204 


EOT 


174 


EOT 


174 


7644 


ENQ 


005 


ENQ 


005 


NULL 




NULL 




7645 






ACK 


006 


ACK 


006 


ACK 


067 


NULL 




7646 




BELL 


207 


BELL 


207 


NULL 




NULL 




7647 






BS 


210 


BS 


210 


BS 


135 


BS 


135 


7650 


HT 


01 1 


HT 


01 1 


HT 


057 


HT 


057 


7651 


LF 


012 


LF 


012 


LF 


156 


LF 


156 


7652 


VT 


213 


VT 


213 


NULL 




NULL 




7653 






FF 


014 


FF 


014 


NULL 




NULL 




7654 






CR 


215 


CR 


215 


CR 


155 


CR 


155 


7655 


SO 


216 


SO 


216 


UCS 


034 


UCS 


034 


7656 


SI 


017 


SI 


017 


LCS 


037 


LCS 


037 


7657 


DLE 


220 


DLE 


220 


NULL 




NULL 




7660 






DCI 


021 


DCI 


021 


NULL 




NULL 




7661 






DC2 


022 


DC2 


022 


NULL 




NULL 




7662 






DC3 


023 


DC3 


023 


NULL 




NULL 




7663 






DC4 


024 


DC 4 


024 


STO 


054 


STO 


064 


7664 


NAK 


225 


NAK 


225 


NAK 


001 


NAK 


001 


7665 


SYN 


226 


SYN 


226 


IL 


075 


IL 


075 


7666 


ETB 


027 


ETB 


027 


EOB 


136 


EOB 


136 


7667 


CAN 


030 


CAN 


030 


DEL 


177 


DEL 


137 


7670 


EM 


231 


EM 


231 


NULL 




NULL 




7671 






SUB 


232 


SUB 


232 


NULL 




NULL 




7672 






ESC 


033 


ESC 


033 


PF 


076 


PF 


076 


7673 


FS 


234 


FS 


234 


NULL 




NULL 




7674 






GS 


035 


GS 


035 


NULL 




NULL 




7675 






RS 


036 


RS 


036 


NULL 




NULL 




7676 






US 


237 


US 


237 


NULL 




NULL 




7677 






NULL 




NULL 




NULL 




NULL 




7400 










@ 


300 


< 


044 


@ 


020 


< 


004 


7401 


/\ 


336 


— 


042 


NULL 




— 


020 


7402 




NULL 




NULL 




CNL 


001 
153 


CNL 


001 

121 


7403 
7404 


072 


276 


NULL 




NULL 




NULL 




NULL 




7405 










NULL 




NULL 




NULL 




NULL 




7406 










' 


140 


NULL 




NULL 




NULL 




7407 









60435400 C 



l-A-3 



NOS STANDARD CHARACTER SET 



CDC 
GRAPHIC 


ASCII 

GRAPHIC 

SUBSET 


DISPLAY 
CODE 


HOLLERITH 

PUNCH 

(026) 


EXTERNAL 

BCD 

CODE 


ASCII 

PUNCH 

(029) 


ASCII 
CODE 


:t 


;. 


oot 


8-2 


00 


8-2 


3A 


A 


A 


01 


12-1 


6 1 


12-1 


41 


B 


B 


02 


12-2 


62 


12-2 


42 


C 


C 


03 


12-3 


63 


12-3 


43 


D 


D 


04 


12-4 


64 


12-4 


44 


E 


E 


05 


12-5 


65 


12-5 


45 


F 


F 


06 


12-6 


66 


12-6 


46 


G 


G 


07 


12-7 


67 


12-7 


47 


H 


H 


1 


12-8 


70 


12-8 


48 


1 


1 


1 1 


12-9 


7 1 


12-9 


49 


J 


J 


12 


ll-l 


41 


ll-l 


4A 


K 


K 


13 


11-2 


42 


11-2 


4B 


L 


L 


14 


11-3 


43 


11-3 


4C 


M 


M 


15 


11-4 


44 


11-4 


4D 


N 


N 


16 


11-5 


45 


11-5 


4E 








17 


11-6 


46 


11-6 


4F 


P 


P 


20 


11-7 


47 


11-7 


50 


Q 


Q 


21 


11-8 


50 


11-8 


51 


R 


R 


22 


11-9 


51 


11-9 


52 


S 


S 


23 


0-2 


22 


0-2 


53 


T 


T 


24 


0-3 


23 


0-3 


54 


U 


U 


25 


0-4 


24 


0-4 


55 


V 


V 


26 


0-5 


25 


0-5 


56 


w 


w 


27 


0-6 


26 


0-6 


57 


X 


X 


30 


0-7 


27 


0-7 


58 


Y 


Y 


3 1 


0-8 


30 


0-8 


59 


z 


z 


32 


0-9 


3 1 


0-9 


5A 








33 





12 





30 


1 


1 


34 


1 


01 


1 


31 


2 


2 


35 


2 


02 


2 


32 


3 


3 


36 


3 


03 


3 


33 


4 


4 


37 


4 


04 


4 


34 


5 


^ 


40 


5 


05 


5 


35 



3AEI3A 



t TWELVE OR MORE ZERO BITS AT THE END OF A 60- BIT WORD ARE 
INTERPRETED AS END-OF-LINE MARK RATHER THAN TWO COLONS. 



l-A-4 



6 0435400 B 





ASCII 




HOLLERITH 


EXTERNAL 


ASCII 




CDC 


GRAPHIC 


DISPLAY 


PUNCH 


BCD 


PUNCH 


ASCII 


GRAPHIC 


SUBSET 


CODE 


(026) 


CODE 


(029) 


CODE 


6 


6 


41 


6 


06 


6 


36 


7 


7 


42 


7 


07 


7 


37 


8 


8 


43 


8 


10 


8 


38 


9 


9 


44 


9 


1 1 


9 


39 


+ 


+ 


45 


12 


60 


12-8-6 


2B 


- 


- 


46 


1 1 


40 


1 1 


2D 


* 


* 


47 


1 1-8-4 


54 


1 1-8-4 


2A 


/ 


/ 


50 


0-1 


21 


0-1 


2F 


( 


( 


5 1 


0-8-4 


34 


12-8-5 


28 


) 


) 


52 


12-8-4 


74 


1 1-8-5 


29 


$ 


$ 


53 


1 1-8-3 


53 


1 1-8-3 


24 


= 


= 


54 


8-3 


13 


8-6 


3D 


BLANK 


BLANK 


55 


NO PUNCH 


20 


NO PUNCH 


20 


.(COMMA) 


.(COMMA) 


56 


0-8-3 


33 


0-8-3 


2C 


.(PERIOD) 


.(PERIOD) 


5 7 


12-8-3 


73 


12-8-3 


2E 


£E 


# 


60 


0-8-6 


36 


8-3 


23 


c 


[ 


6 1 


8-7 


17 


12-8-2 


5B 


] 


3 


62 


0-8-2 


32 


11-8-2 


5D 


%t 


% 


63 


8-6 


16 


0-8-4 


25 


± 


" (QUOTE) 


64 


8-4 


14 


8-7 


22 


-~ 


__ (UNDERLINE) 


65 


0-8-5 


35 


0-8-5 


5F 


V 


l 


66 


1 1-0 


52 


12-8-7 


21 


A 


a 


67 


0-8-7 


37 


12 


26 


t 


'(APOSTROPHE) 


70 


1 1-8-5 


55 


8-5 


27 


1 


? 


71 


1 1-8-6 


56 


0-8-7 


3F 


< 


< 


72 


12-0 


72 


12-8-4 


3C 


> 


> 


73 


1 1-8-7 


57 


0-8-6 


3E 


< 





74 


8-5 


15 


8-4 


40 


> 


\ 


75 


12-8-5 


75 


0-8-2 


5C 


-. 


— (CIRCUMFLEX) 


76 


12-8-6 


76 


1 1-8-7 


5E 


; (SEMICOLON) 


; (SEMICOLON) 


77 


12-8-7 


77 


1 1-8-6 


3B 



3AE6A 



+ IN INSTALLATIONS USING THE CDC 63 -GRAPHIC SET, DISPLAY CODE 00 HAS NO ASSOCIATED 
GRAPHIC OR HOLLERITH CODE; DISPLAY CODE 63 IS THE COLON (8-2 PUNCH). THE 
SELECTION OF THE 63- OR 64-CHARACTER SET FOR TAPES IS AN INSTALLATION OPTION. 



60435400 A 



l-A-5 



ASCII/DISPLAY CODE AND EBCDIC/DISPLAY CODE CONVERSION 



DISPLAY 


ASCII 


EBCDIC 


CODE 


UPPERCASE 


LOWERCASE 


UPPERCASE 


LOWERCASE 


OCTAL 


CHAR 


CHAR 


HEX 


CHAR 


HEX 


CHAR 


HEX 


CHAR 


HEX 


00 






3A 


SUB 


IA 


: 


7A 


SUB 


3F 


01 


A 


A 


41 


a 


61 


A 


CI 


a 


81 


02 


B 


B 


42 


b 


62 


B 


C2 


b 


82 


03 


C 


C 


43 


c 


63 


C 


C3 


c 


83 


04 


D 


D 


44 


d 


64 


D 


C4 


d 


84 


05 


E 


E 


45 


e 


65 


E 


C5 


e 


85 


06 


F 


F 


46 


f 


66 


F 


C6 


f 


86 


07 


G 


G 


47 


g 


67 


G 


C7 


g 


87 


10 


H 


H 


48 


h 


68 


H 


C8 


h 


88 


1 1 


I 


I 


49 


i 


69 


I 


C9 


i 


89 


12 


J 


J 


4A 


i 


6A 


J 


Dl 


J 


91 


13 


K 


K 


4B 


k 


6B 


K 


D2 


k 


92 


14 


L 


L 


4C 


1 


6C 


L 


D3 


1 


93 


15 


M 


M 


4D 


m 


6D 


M 


D4 


m 


94 


16 


N 


N 


4E 


n 


6E 


N 


D5 


n 


95 


17 








4F 





6F 





D6 





96 


20 


P 


P 


50 


P 


70 


P 


D7 


P 


97 


21 


Q 


Q 


51 


q 


71 


Q 


D8 


q 


98 


22 


R 


R 


52 


r 


72 


R 


D9 


r 


99 


23 


S 


S 


53 


s 


73 


S 


E2 


s 


A2 


24 


T 


T 


54 


t 


74 


T 


E3 


t 


A3 


25 


U 


U 


55 


u 


75 


U 


E4 


u 


A4 


26 


V 


V 


56 


V 


76 


V 


E5 


V 


A5 


27 


w 


w 


57 


w 


77 


w 


E6 


w 


A6 


30 


X 


X 


58 


X 


78 


X 


E7 


X 


A7 


31 


Y 


Y 


59 


y 


79 


Y 


E8 


y 


A8 


32 


z 


z 


5A 


z 


7A 


z 


E9 


z 


A9 


33 








30 


DLE 


10 





FO 


DLE 


10 


34 


1 


1 


31 


DCI 


1 1 


1 


Fl 


DCI 


II 


35 


2 


2 


32 


DC2 


12 


2 


F2 


DC2 


12 


36 


3 


3 


33 


DC3 


13 


3 


F3 


TM 


13 


37 


4 


4 


34 


DC 4 


14 


4 


F4 


DC4 


3C 



3AE7A 
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60435400 A 



DISPLAY 
CODE 


ASCII 




EBCDIC 




UPPERCASE 


LOWERCASE 


UPPERCASE 


LOWERCASE 


OCTAL 


CHAR 


CHAR 


HEX 


CHAR 


HEX 


CHAR 


HEX 


CHAR 


HEX 


40 


5 


5 


35 


NAK 


15 


5 


F5 


NAK 


3D 


4 1 


6 


6 


36 


SYN 


16 


6 


F6 


SYN 


32 


42 


7 


7 


37 


ETB 


17 


7 


F7 


ETB 


26 


43 


8 


8 


38 


CAN 


18 


8 


F8 


CAN 


18 


44 


9 


9 


39 


EM 


19 


9 


F9 


EM 


19 


45 


+ 


+ 


2B 


VT 


OB 


+ 


4E 


VT 


OB 


46 


- 


- 


2D 


CR 


OD 


- 


60 


CR 


OD 


47 


* 


* 


2A 


LF 


OA 


* 


5C 


LF 


25 


50 


/ 


/ 


2F 


SI 


OF 


/ 


61 


SI 


OF 


51 


(. 


( 


28 


BS 


08 


( 


4D 


BS 


16 


52 


) 


) 


29 


HT 


09 


) 


5D 


HT 


05 


53 


$ 


$ 


24 


EOT 


04 


$ 


5B 


EOT 


37 


54 


= 


= 


3D 


GS 


ID 


= 


7E 


I(?S 


ID 


55 


SP 


SP 


20 


NUL 


00 


SP 


40 


NUL 


00 


56 


» 


> 


2C 


FF 


OC 


• 


6B 


FF 


OC 


57 


. 


. 


2E 


SO 


OE 


. 


4B 


SO 


OE 


60 


= 


# 


23 


ETX 


03 


# 


7B 


ETX 


03 


61 


[ 


c 


5B 


FS 


IC 


$ 


4A 


IFS 


IC 


62 


] 


] 


5D 


SOH 


01 


l 


5A 


SQH 


01 


63 


% 


% 


25 


ENQ 


05 


% 


6C 


ENQ 


2D 


64 


* 


II 


22 


STX 


02 


ii 


7F 


STX 


02 


65 


r 





5F 


DEL 


7F 





6D 


DEL 


07 


66 


V 


1 


21 


) 


7D 


1 


4F 


1 


DO 


67 


A 


a 


26 


ACK 


06 


a 


50 


ACK 


2E 


70 


t 


i 


27 


BEL 


07 


■ 


7D 


BEL 


2F 


71 


1 


? 


3F 


US 


IF 


? 


6F 


IUS 


IF 


72 


< 


< 


3C 


{ 


7B 


< 


4C 


f 


CO 


73 


> 


> 


3E 


RS 


IE 


> 


6E 


IRS 


IE 


74 


< 


@ 


40 


\ 


60 


@ 


7C 


\ 


79 


75 


> 


\ 


5C 


1 
l 


7C 


\ 


EO 


1 
l 


6A 


76 


-, 


A 


5E 


rs* 


7E 


—i 


5F 


/N> 


Al 


77 


> 


> 


3B 


ESC 


IB 


> 


5E 


ESC 


27 



3AE8A 



60435400 A 



l-A-7 



CARRIAGE CONTROL CHARACTERS 



CHARACTER 



SPACE 
I 


+ 
/ 
2 
8 
7 
6 
5 
4 
3 
H 
6 
F 
E 
D 
C 


R 

S 



COMMAND 



SINGLE SPACE 
EJECT PAGE BEFORE PRINT 
SKIP ONE LINE BEFORE PRINT (DOUBLE SPACE) 
SKIP TWO LINES BEFORE PRINT (TRIPLE SPACE) 
SUPPRESS SPACE BEFORE PRINT 
SUPPRESS SPACE AFTER PRINT 
SKIP TO LAST LINE OF FORM BEFORE PRINT 
SKIP TO FORMAT CHANNEL I BEFORE PRJNT t 
SKIP TO FORMAT CHANNEL 2 BEFORE PRINT t 
SKIP TO FORMAT CHANNEL 3 BEFORE PRINT t 
SKIP TO FORMAT CHANNEL 4 BEFORE PRINT t 
SKIP TO FORMAT CHANNEL 5 BEFORE PRINT t 
SKIP TO FORMAT CHANNEL 6 BEFORE PRINT t 
SKIP TO FORMAT CHANNEL I AFTER PRINT 
SKIP TO FORMAT CHANNEL 2 AFTER PRINT 
SKIP TO FORMAT CHANNEL 3 AFTER PRINT 
SKIP TO FORMAT CHANNEL 4 AFTER PRINT 
SKIP TO FORMAT CHANNEL 5 AFTER PRINT 
SKIP TO FORMAT CHANNEL 6 AFTER PRINT 
CLEAR AUTO EJECT; REMAINDER OF LINE IS 
NOT PRINTED 

SET AUTO EJECT; REMAINDER OF LINE IS 
NOT PRINTED 

SELECT 6 LINES/ INCH; 1 1 REMAINDER OF 
LINE IS NOT PRINTED 

SELECT 8 LINES/INCH; 1 1 REMAINDER OF 
LINE IS NOT PRINTED 



3AE9A 



tNo space after print. For all other control characters, a line 
feed is issued after print. 

ffUsed only on the 512 and 580 line printers. The deselection 
of auto eject mode on a 512 or 580 line printer results in the 
deselection of 8 lines per inch, if previously selected. 
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DAYFILE MESSAGES B 



This appendix contains an alphabetical listing of the messages which may appear in a 
user's dayfile. Lowercase characters are used to identify variable names or fields. 
If the first word or characters are variable, the message is listed according to the 
second word. For example, the message 

pfn ALREADY PERMANENT, AT nnn. 

is listed alphabetically with the messages beginning with the letter A. This is done 
because the variable pfn (permanent file name) may change each time the message is 
issued. All messages beginning with numbers follow the alphabetical listing. 

The CIO and PFM file processors utilize the file environment table (FET) as a communi- 
cation area to contain information about the requests of a user's job. Higher level 
languages (COBOL, FORTRAN, etc.) automatically establish and use these areas but the 
COMPASS programmer must define the FET. (Refer to volume 2 for detailed infor- 
mation on the FET. ) CIO and PFM error messages contain the address, nnn, of the 
FET associated with the request and the logical file name, fff, from word zero of the 
table (FET+0). 

When the error processing (ep) bit is set in word 1 of the FET, status information is 
returned by the function processor when an abnormal situation or error occurs. The 
abnormal termination codes are returned to bits 10 through 13 of word zero of the FET 
(bits 10 through 17 of PFM). Following the alphabetical listing of messages is a list 
of LFM and PFM error codes and explanations. Also included at the end of this sec- 
tion is a table summary of the action taken by PFM when an error is detected while 
reading mass storage. 
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Message 


Routine 


Description 


ACCOUNT BLOCK LIMIT. 


3AB 


The monitor detected the expiration of the account block SRU limit. 


ADDRESS ERROR. 


TCS 


CM address in call is beyond the field length. 


ADDRESS OUT OF RANGE aaaaaa. 


CPMEM 


The address aaaaaa on a correction statement is greater than or equal to the 
user's field length. The correction statement is ignored and LOC continues. 


pfn ALREADY PERMANENT. AT nnn. 


PFM 


The user has already saved or defined a file with the name specified. 


ARC ERROR. 


LDR 


LDR parameters were outside the user's field length. 


ARGUMENT ERROR. 


RESEX/ISF 


A control statement is syntactically incorrect. Recheck parameters. On tape 
management statements, the system issues this message if both ring enforcement 
options (PO=R and PO=W) or more than one EOT option (PO=I, PO=P, PO=S) 
is specified. 


ARITH, ERROR x AT yyyyyy. 


3AB 


The monitor detected an arithmetic error condition x at address yyyyyy. 


BAD DECK NAME. 


TCS 


A deck name of more than 7 characters was encountered. 


BINARY SEQ. ERROR, RECxxxx CDyyyy. 




A binary card was found to be out of sequence and the job was terminated. 

xxxx Number (in octal) of record in which sequence error occurred. 

yyyy Number (in octal) of card within the record which caused the 
sequence error. 


BLANK TAPE, fff AT nnn. 


1MT 


A blank tape was encountered on a read operation. (Blank tape is defined as 
more than 25 feet of erased tape. ) 


BLOCK COUNT ERROR IN TRAILER LABEL, fff AT nnn. 


1MT 


The block count in the EOF1 or EOV1 label did not match the block count 
maintained by the tape executive during the read operation. 


BLOCK LENGTH ERROR ON fff AT nnn. 


1MT 


The software -recorded block length did not match the length of the block read 
(this message applies to I format tapes only). 


BLOCK SEQUENCE ERROR, fff AT nnn. 


1MT 


The software -recorded block length did not match the length of the block read, 
or the block number did not match the software -record block number (this 
message applies to I format tapes only). 


BLOCK TOO LARGE ON fff AT nnn. 


1MT 


The tape being read contained a data block greater in size than that allowed by the speci- 
fied format or by user declaration (this message applies to S or L format tapes only). 


BOT/EOT ENCOUNTERED, fff AT nnn. 


1MT 


Indicates an abnormal tape position. 


BUFFER ARG. ERROR. 


TCS 


CM address in call is not less than the field length minus the word count; buffer 
extends past the job's field length. 


BUFFER ARGUMENT ERROR. 


QFM 


A buffer pointer did not conform to the following constraints. 

FIRST < IN 

FIRST < OUT 

OUT < LIMIT < , FL 



Message 


Routine 


Description 


BUFFER ARGUMENT ERROR ON fff AT nnn. 


CIO/1MT 


A buffer pointer did not conform to the following constraints. 

FIRST < IN 

FIRST < OUT 

OUT < LIMIT < FL 

The system provides a dump of the FET on file OUTPUT. 


BUFFER CONTROL WORD ERROR ON fff AT nnn. 


CIO/1MT 


The block length specified during a write operation was greater than the allowable PRU 
size for the device. For tape operations, this message can also Indicate that the unused 
bit count is illegal or that an attempt was made to write a record shorter than the noise 
record size. 


pfn BUSY, AT nnn. 


PFM 


The specified direct access file is attached in the opposite mode, or it 
is currently being accessed by one of the following. 

• More than 77B users in READ mode 

• More than 77B users in READAP mode 

• More than 7777B users in READMD mode 


n CARD(S) NOT PROCESSED. 




Errors on n directives prevented them from being processed. 


CATALOG OVERFLOW - FILES, AT nnn. 


PFM 


The number of files in the user's catalog exceeds his limit (refer to LIMITS 
control statement, section 6). 


CATALOG OVERFLOW - SIZE AT nnn. 


PFM 


The cumulative size of the indirect access files in the user's catalog exceeds 
his limit (refer to LIMITS control statement, section 6). 


CHANNEL MALFUNCTION, fff AT nnn. 


1MT 


Hardware malfunction. 


CHARGE ABORTED. 


CHARGE 


A central site operator action caused the CHARGE operation to abnormally termi- 
nate. Resubmit job. 


CHARGE FILE BUSY. 


CHARGE 


The file which the system uses to validate charge number and project number Is 
busy. /Resubmit job. 


CHARGE ILLEGAL AT THIS HOUR. 


CHARGE 


The specified project number cannot be used at this time of the day. 


CHECKPOINT nnnn COMPLETE. 


CHKPT 


Indicates that checkpoint nnnn has been completed. Issued if only one checkpoint 
file is present. For a checkpoint operation, more than two checkpoint files or an 
illegal combination of checkpoint files were specified. 


CHECKPOINT nnnn COMPLETED TO xxxxxxx. 


CHKPT 


Indicates that checkpoint nnnn has been completed to file xxxxxxx. Issued if 
alternate CB checkpoint files are used. 


CHECKPOINT FILE ERROR. 


CHKPT/RESTART 


During a restart operation, either the checkpoint file If n specified on the RESTART 
control statement was empty or RESTART detected a format error attempting to 
read the specified checkpoint file. 


CHECKPOINT NOT FOUND. 


RESTART 


The specified checkpoint (nn parameter on RESTART statement) could not be 
found on the file. 


CKP REQUEST. 


CHKPT 


A checkpoint has been initiated. 


CM NOT VALIDATED. 


TCS 


The number of CM words specified on the job statement exceeds that for which the 
user is validated. 
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Message 


Routine 


Description 


COMPILER NOT IN LIBRARY. 


TCS 


An LDC control statement requested loading of a compiler not on the system. 


CONTROL CARD ARGUMENT ERROR. 


QFSP 


An invalid argument was encountered on a control statement. 


CONTROL CARD ERROR. 




Loader failed to find the requested file. 


CONTROL STATEMENT LIMIT. 


1AJ 


The number of control statements processed for a job has exceeded the limit for 
which the user is validated. 


CONVERSION NOT FOUND. 


PFM 


The conversion table specified by the TS option was not found. 


CONVERSION NOT SPECIFIED. 




Neither a TS nor 64 option was specified on a CONVERT control statement. 


COPY COMPLETE. 


COPY 


Informative message issued when a system file copy is complete. 


CORE OVERFLOW, JOB ABORTED. 


CPM 


Table overflow occurred; rerun using more central memory field length. 


CPxx, ... . 




Refer to the EQxx, ... series of corresponding messages for full descriptions of 
messages beginning with CPxx, ... . 


CPM ARC ERROR. 


CPM 


Error(s) encountered and job aborted. 


CPM ILLEGAL REQUEST. 


CPM 


A CPM function was issued without the auto recall specified or job was not of 
system origin. 


CPU ERROR EXIT xx AT yyyyyy. 


1AJ 


Monitor has detected a CPU error exit condition xx at address yyyyyy (refer 
to Error Control, section 3). 


CRxx,... . 




Refer to the EQxx,... series of corresponding messages for full descriptions of 
messages beginning with CRxx, ... . 


CUX - ILLEGAL *USER ACCESS 




Account not validated for system privileges. 


DATA BASE ERROR. 


CHARGE/ 
MODVAL 


One /of the following: 

The system detected an error in its validation file. 
The user should contact installation personnel. 


DATA BASE ERROR n. 


PROFILE 


An abnormal error has been detected. Notify the analyst. 


DATA TRANSFER ERROR, AT nnn. 


PFM 


An error occurred in a read operation during a file transfer. 


DAYFILE TERMINATED 


SFM 


Informative message issued to the terminated dayflle. 


xxxxxx DAYFILE TERMINATED. 


SFM 


Informative message indicating dayfile xxxxxx has been terminated (issued to 
system and control point dayfiles). 
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Message 


Routine 


Description 


DExx, Cyy, ec, ann, Stttt, Axxxxxxx. 

i 


6DE 


An error has been detected on extended core storage. The nature of the error 
is determined by examining each parameter in the message. 

xx EST ordinal of ECS unit 

yy Channel number 

ec Error code; one of the following: 

PE Parity error/checkword error 

AD Address error 

ST Device status error 

RS Device reserved 

NR Device not ready 

a Type of operation; one of the following: 

R Read 
W Write 

nn Retry count; error is considered irrecoverable after the following 
number of retries: 

PE 10 

AD 10 

ST 64 

FN 10 

RS Indefinite 

NR Indefinite 

tttt Device status; implies there was an incomplete transfer if status 
does not indicate an error 

Axxxxxxx Physical address at beginning of block 


DEMAND EXCEEDED., 


RESEX 


The user attempted to assign more units than he scheduled on the RESOURC 
statement. 


DEMAND INSTALLATION ERROR. 


RESEX 


The user requested more units than exist at the installation. 


DEMAND VALIDATION ERROR. 


RESEX 


The specified number of units exceeds the user's validation limits. 


DENSITY CHANGE, fff AT nnn. 


1MT 


The density of the tape changed during a read or write operation. If this error 
occurs on the first block on the tape, the additional message 

DENSITY SPECIFIED DIFFERENT FROM TAPE, 
is issued. In requesting the tape, the user should specify the density in which 
the tape was written. 


DEVICE ERROR ON FILE fff AT nnn. 


CIO 


An irrecoverable error occurred on the mass storage device containing the file fff. 


DEVICE UNAVAILABLE, AT nnn. 


PFM 


Access to the permanent file device requested is not possible. User may have 
attempted to access files on a device not present in the alternate system. 
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Message 

DIxx, Cyy, ec, arm, Stttt, FNqqqq. 

or 
DIxx, Cyy, ec, ann, Stttt, Uuu Ccccc Sttss. 



DIRECT ACCESS DEVICE ERROR, AT nnn. 



DIRECTIVE ERRORS. 

n DIRECTIVE ERROR(S). 
DIRECTIVE CARD ERROR. 



Routine 



6DI 



PFM 



PROFILE/ 
MODVAL/ 
OPLEDIT 

PROFILE 

PROFILE 



xx 

yy 



Description 

An error has been detected on mass storage device xx. The nature of the error 
is determined by examining each parameter in the message. 

EST ordinal of 844-21 disk 

Channel number 

Error code (one of the following): 

PE Parity error /checkword error 

AD Address error 

ST Device status error 

FT Function timed out with no response 

RS Device reserved 

NR Device not ready 

CR Controller reserved 

Type of operation (one of the following) : 

R Read 

W Write 

Retry count; error is considered Irrecoverable after the following 
number of retries: 



PE 


10 


AD 


10 


ST 


64 


FT 


3 


RS 


Indefinite 


NR 


Indefinite 


CR 


Indefinite 



tttt 
qqqq 

Uuu 

Ccccc 

Sttss 



Device status; implies there was an Incomplete transfer If 

status does not Indicate an error 

Function which timed out 

Physical unit 

Physical cylinder \ Physical address 

tt Physical track 

ss Physical sector 



The specified file already exists on a device other than the device requested or an 
Illegal device type was specified. The device on which the file resides may not 
contain direct access files because: 

• The device Is not specified as a direct access device in the catalog 
descriptor table. 

• The device Is not specified as ON and Initialized In the catalog 
descriptor table. 

• The device Is a dedicated indirect access permanent file device. 

If on an alternate system, the user's master device may not have been transferred 
to that system. 

An Invalid directive statement was encountered. If the message Is Issued In re- 
sponse to a PROFILE request, refer to the specific directive errors as listed for 
output file diagnostics. 

Occurs when there are conflicts or omissions in implied deletes or Insertions. 

Occurs when an Illegal directive statement Is encountered; for example, syntax 
error. 
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Message 

DJxx, Cyy, ec, ann, Stttt, FNqqqq. ( 

or 
DJxx, Cyy, ec, ann, Stttt, Uuu Ccccc Sttss. 



Routine 



6DJ 



Description 

An error was detected on mass storage device xx. The nature of the error is 
determined from the parameters in the message. 

xx EST ordinal of 844-41 disk 

yy Channel number 

ec Error code (one of the following): 

PE Parity error /checkword error 

AD Address error 

ST Device status error 

FT Function timed out with no response 

RS Device reserved 

NR Device not ready 

CR Controller reserved 

a Type of operation (one of the following): 



R 

W 



Read 
Write 



Retry count; error is considered irrecoverable after the following 
number of retries: 



PE 
AD 
ST 
FT 
RS 
NR 
CR 



10 
10 
64 
3 
Indefinite 
Indefinite 
Indefinite 



tttt 

qqqq 

Uuu 
Ccccc 

Sttss 



Device status; implies there was an incomplete transfer if the status 

does not indicate an error 

Function which timed out 

Physical unit 

Physical cylinder 

tt Physical track 

ss Physical sector 



Physical address 
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Message 
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DPxx, Cyy, ec, ann, Stttt, Axxxxxxx. 



DSP - CAN NOT ROUTE JOB INPUT FILE. 
DSP - COMPLETE BIT ALREADY SET. 
DSP - DEVICE UNAVAILABLE 

DSP - FILE NAME ERROR. 

DSP - FILE NOT ON MASS STORAGE. 

DSP - FILE ON REMOVABLE DEVICE. 

DSP - FORMS CODE NOT ALPHANUMERIC. 

DSP - FNT/DEVICE FULL. 

DSP - ILLEGAL FILE TYPE. 

DSP - ILLEGAL ORIGIN TYPE 

DSP - ILLEGAL REQUEST. 



Routine 



6DP 



DSP 
DSP 
DSP 

DSP 
DSP 
DSP 
DSP 
DSP 
DSP 
DSP 

DSP 



xx 

yy 



Description 

An error has been detected on distributive data path (DDP). The nature of the 
error is determined by examining each parameter in the message. 

EST ordinal of DDP/ ECS 

Channel number 

Error code (one of the following): 

PE Parity error/checkword error 

AD Address error 

ST Device status error 

RS Device reserved 

NR Device not ready 

Type of operation (one of the following): 

R Read 

W Write 

Retry count; error is considered irrecoverable after the following 
number of retries: 



PE 


10 


AD 


10 


ST 


64 


FN 


10 


RS 


Indefinite 


NR 


Indefinite 



tttt Device status; implies there was an incomplete transfer if status 

does not indicate an error 

Axxxxxxx Physical address at beginning of block 

The job input file cannot be routed. 

The complete bit was not cleared before DSP was called. 

DSP attempted to create a file on a device that was turned off or currently 
unavailable for access. 

An attempt was made to create a file with an invalid file name. 

An attempt was made to route a file not on. mass storage. 

A file on a removable device cannot be routed. 

Forms code must consist of two alphanumeric characters. 

There is no space in the FNT or on the device for current use. 

The file being processed is not a PRFT, PHFT, INFT, or LOFT file type. 

DSP cannot route the file to the input queue with the origin type specified 
by the caller. 

One of the following: 

1. DSP was not called with recall (does not apply when queue priority 
is greater than MXPS). 

2. Parameter list address was out of range. 
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Message 


Routine 


Description 


DSP - ILLEGAL USER CARD. ., 


DSP 


User attempted to route a file with an illegal USER statement to the input queue. 


DSP - IMMEDIATE ROUTINE - NO FILE. 


DSP 


The specified file for the immediate routing could not be found. 


DSP - INVALID DISPOSITION CODE. 


DSP 


Specified disposition code is not recognized. 


DSP - INVALID EXTERNAL CHARACTERISTICS 


DSP 


Caller specified an undefined external characteristic code. 


DSP - INVALID TID. 


DSP 


One of the following: 

1. User number and family name parameters were not in CM field length. 

2. TID is greater than or equal to IDLM for batch jobs. 

3. User number specified in parameter block does not compare with 
user number in control point area. 


DSP - I/O SEQUENCE ERROR, 


DSP 


A request was made on a busy file. 


DSP - LOCAL FILE LIMIT. 


DSP 


User has exceeded his/her local file validation limits. 


DSP - OUTPUT FILE LIMIT. 


DSP 


Caller has exceeded his/her output file validation. 


DSP - ROUTE TO INPUT NOT IMMEDIATE. 


DSP 


Routing a file to the input queue must be immediate. 


DSP - THIS ROUTING NOT ALLOWED. 


DSP 


An attempt was made to change the origin type or queue type of a deferred 
routed file. 


DSP - TOO MANY DEFERRED BATCH JOBS. 


DSP 


User has more jobs in the system than allowed. This check is ignored 
for users with system origin privileges. 


DUMP FWA .GE. LWA+1. 


CPMEM 


The first word address of memory to be dumped was greater than the last word 
address plus 1 of memory. 


DUPLICATE COMMON FILE NAME 


LFM 


A file of the same name as that specified in a COMMON or STAGE request already 
exists. 


DUPLICATE FILE NAME. 


LFM 


The file specified already exists in the system. 


DUPLICATE LINES. 




Lines being dumped during a DMP operation were duplicated and suppressed. 


DUPLICATE PROJECT NUMBER. 


PROFILE 


During a create run, PROFILE detected two or more identical project numbers 
within one charge number entry. The first project number is retained; all 
subsequent duplicate numbers are disregarded. All other project numbers are 
processed normally. 


DUPLICATE USER NUMBER. 


PROFILE 


This message is printed if PROFILE detected two or more identical user num- 
bers in one project number entry, or the user attempts to update the project 
profile file by adding a user number that already exists under the specified project 
number. The entire proejet number entry containing the duplicate user numbers is 
disregarded. 
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Message 


Routine 


Description 


ECS LOAD ERROR. 


3AE 


Bad load address from ECS. 


EDITING COMPLETE. 




Informative message. 


lfn EMPTY, AT nnn. 


PFM 


The file specified on a SAVE request contains no data. 


EMPTY CATALOG. 


CATLIST 


No entries are present in the catalog. 


EMPTY SORT INPUT FILE. 


MSORT 


File lfn specified on the SORT control statement contains no data. 


END OF INFORMATION ENCOUNTERED. 


COPY 


Informative message issued when a local file copy is completed. 


END OF TAPE, fff AT nnn. 


1MT 


The end of tape was encountered. 


ENQUIRY COMPLETE. 


ENQUIRE 


Informative message issued when processing of ENQUIRE control statement 
is completed. 


ENTRY POINT NOT FOUND. 


3AD 


The specified entry point could not be found on the overlay file. 


EOF ENCOUNTERED BEFORE TERMINATION. 




An end-of-file was encountered on a CONVERT input file before the specified 
record count was reached. 


EOI ENCOUNTERED BEFORE TERMINATION. 




An end-of-information was encountered on a CONVERT input file before the 
specified record count was reached. 


EQ, Ccc-e-uu, vsn, rw, est, Sss, sconj, scon 2 . 
EQ, Ccc-Fff, Iii, Bnnnnnn, Lbbbb, Ppppppppp. 
EQ, Ccc, Eec, H000000000, type. 


1MT 


Three-line message describing a magnetic tape hardware malfunction occurring 
on a 657 or 659 tape unit. 

EQ MT for 657; NT for 659 

The first line provides the following information. 

cc-e-uu Channel, equipment (tape controller), and physical unit num- 
ber of tape unit on which error was encountered. 

vsn Volume serial number associated with the tape on the specified 
unit. 

rw Read (RD) or write (WR) operation: any operation not involving 
an actual read or write is listed as a read. 

est EST ordinal of the unit on which the tape was written. This is 
provided only for labeled tapes generated under NOS 1.0; other- 
wise, the field is blank. 

ss Status of the 6681/6684 interface. First digit represents a uo where 
bit a=2 11 of status; second digit represents bits 2 2 -2° of status. 

sconj Status of the tape controller. 

scon2 Status-2 of the controller, if available. 










The second line of the message contains: 






cc Channel number; the channel number is repeated to allow the 

analyst to associate this message with the first message if errors 
are occurring on more than one tape channel at the same time. 

ff Software function on which the error occurred. 

ii Error iteration; number of times error has been encountered on 
this unit without successful recovery. 

nnnnnn Block number on which error occurred. 

bbbb Length of block on which error occurred, in octal bytes. 

pppppppp 1MT internal error parameters. 
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Message 



EQ, Ccc-uu, vsn, rw, est, Ss, GSgggg. 
EQ.Ccc, Dddd. ..d 

EQ, Ccc, Fff, Iii, Bnnnnnn, Lbbbb, Ppppppppp. 
EQ, Ccc, Eec, Hhhhhhhhh, type. 
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Routine 



1MT 



Description 

The third line of the message contains the following information. 

cc Channel number; the channel number is repeated to allow the 

analyst to associate this message with the first and second mes- 
sages if errors are occurring on more than one tape channel at 
the same time. 
Octal error code value. 

Controller options selected at the time of the error; each two 
digits is a function code. 
Additional description of the error (one of the following): 



ec 
0000000000 

type 



BAD ERASE. 

BLOCK TOO 
LARGE 
BUSY. 
CHANNEL ILL. 

CON. REJ. 
CON. REJ. OFF. 

DENSITY 
CHANGE. 

FNnn, Pyyyy. 



Lbbbb, Bnnnnnn. 



NO EOP. 

NOISE. 

NOT READY. 

ON THE FLY. 

POSITION 

LOST. 

RECOVERED. 

STATUS. 

WRONG 
PARITY. 



Error detected after an erase was attempted to 

recover a write error. 

Data block was larger than expected. 

Unit was still busy after 1 second. 
Channel is not accepting function or status 
requests properly. 

Connect reject; unable to connect to the unit. 
Connect reject; unable to connect to unit. Unit 
turned OFF. 

Either user error where auto select does not 
match user selection (0-track only) or hardware 
error where status does not match user selection. 
Function nn was rejected by the controller; yyyy 
is the address in 1MT where the function was 
initiated. 

The length (bbbb) and block number (nnnnnn) read 
from trailer bytes in block did not match the 
actual length or the block number read; given in 
previous message line. 

No end-of-operation detected from unit within 1 
second. 

A noise block was skipped on the tape. 
Tape unit dropped ready status. 
Error was corrected as the data was read. 
The last good block written cannot be found during 
write recovery. 

Previously reported error has been successfully 
recovered. 

Error type cannot be determined so actual con- 
troller status is returned. 

Tape was written in parity opposite that being 
read. 



Four-line message describing a magnetic tape hardware malfunction occurring on 
a 667 or 669 tape unit. 

EQ MT for 667; NT for 669 

The first line provides the following Information. 

cc-uu Channel and physical unit number of tape unit on which error 

was encountered, 
vsn Volume serial number associated with the tape on the specified 

unit. 
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Message 



Routine 



rw 
est 



gggg 



Description 

Read (RD) or write (WR) operation; any operation not involving an 

actual read or write is listed as a read. 

EST ordinal of the unit on which the tape was written. This is 

provided only for labeled tapes generated under NOS 1. 0; otherwise, 

the field is blank. 

Channel status. 

General status of magnetic tape unit. 



The second line of the message contains: 

cc Channel number; the channel number is repeated to allow the 

analyst to associate this message with the first message if errors 
are occurring on more than one tape channel at the same time. 

ddd. . . d Detailed status of magnetic tape unit. 

The third line of the message contains: 

cc Channel number; repeated to associate this message with the 

previous messages, 
ff Software function on which the error occurred, 

ii Error iteration; number of times error has been encountered on 

this unit without successful recovery, 
nnnnnn Block number on which error occurred, 

bbbb Length of block on which error occurred, in octal bytes, 

pppppppp 1MT internal error parameters. 

The fourth line of the message contains: 

cc Channel number; repeated to associate this message with the 

previous messages, 
ec Octal error code value, 

hhhhhhhh Unit format parameters. Refer to Magnetic Tape Subsystem 

Reference Manual for descriptions of unit format parameter fields, 
type Additional description of the error (one of the following): 



BAD ERASE. 

B.C. RESTART. 
BLOCK TOO 
LARGE. 
BUSY. 
CHANNEL ILL. 

CON. REJ. 
CON. REJ.OFF. 

DENSITY 
CHANGE. 

FNnn, Pyyyy. 



Lbbbb. Bnnnnnn. 
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Error detected after an erase was attempted to 
recover a write error. 

Magnetic tape controller firmware restarted. 
Data block was larger than expected. 

Unit was still busy after 1 second. 
Channel is not accepting function or status re- 
quests properly. 

Connect reject; unable to connect to the unit. 
Connect reject; unable to connect to unit. Unit 
turned OFF. 

Either user error where auto select does not 
match user selection (9-track only) or a hardware 
error where status does not match user selection. 
Function nn was rejected by the controller; yyyy 
is the address in 1MT where the function was 
initiated. 

The length (bbbb) and block number (nnnnnn) read 
from trailer bytes in block did not match the 
actual length or the block number read; given in 
previous message line. 
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Message 



EQxx.CHyy Adddd INCOMPLETE TRANSFER. 



EQxx.CHyy CONTROLLER HUNG BUSY. 



EQxx.CHyy Fzzzz FUNCTION TIMEOUT. 



I 



Routine 



HO 



HO 



no 



Description 

NO EOP. No end-of-operation detected from unit within 1 

second. 

NOISE. A noise block was skipped on the tape. 

NOT READY. Tape unit dropped ready status. 

ON THE FLY. Error was corrected as the data was read. 

POSITION The last good block written cannot be found 

LOST. during write recovery. 

RECOVERED. Previously reported error has been successfully 
recovered. 

STATUS. Error type cannot be determined so actual con- 

troller status is returned. 

WRONG Tape was written in parity opposite that being 

PARITY. read. 

An incomplete data transfer was detected by a local batch equipment driver. 

EQ One of the following equipment types: 

CP 415 card punch 

CR 405 card reader 

LP 512 or 580 line printer 

LQ 512 line printer 

LR 580 line printer 



yy 

dddd 



EST ordinal of local batch equipment 

Channel number 

Octal byte count not transferred 



The specified local batch controller did not drop BUSY status. 

EQ One of the following equipment types: 

CP 415 card punch 

CR 405 card reader 

LP 512 or 580 line printer 

LQ 512 line printer 

LR 580 line printer 



xx 

yy 



EST ordinal of local batch equipment 
Channel number 



No response (inactive) was received after issuing a function code to the specified 
local batch equipment (converter and equipment status unavailable). 



EQ 



xx 

yy 

zzzz 



One of the following equipment types: 

CP 415 card punch 

CR 405 card reader 

LP 512 or 580 line printer 

LQ 512 line printer 

LR 580 line printer 

EST ordinal of local batch equipment 
Channel number 
Function code 
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Message 


Routine 


Description 


EQxx, CHyy Fzzzz REJ Paaaa, Cbbbb, Ecccc. 


HO 


Detected function reject or transmission parity error on the specified local batch 
' equipment. 

EQ One of the following equipment types: 

CP 415 card punch 

CR 405 card reader 

LP 512 or 580 line printer 

LQ 512 line printer 

LR 580 line printer 

xx EST ordinal of local batch equipment 

yy Channel number 

zzzz Function code 

aaaa Driver (1CD) address 

bbbb Converter status 

cccc Equipment status 


EQxx, CHyy RESERVED. 


no 


The specified local batch equipment is reserved and cannot be connected on 
channel yy. 

EQ One of the following equipment types: 

CP 415 card punch 

CR 405 card reader 

LP 512 or 580 line printer 

LQ 512 line printer 

LR 580 line printer 

xx EST ordinal of local batch equipment 
yy Channel number 


EQxx. CHyy TURNED OFF. 


no 


The specified local batch equipment was logically turned off (OFF status set in 
EST). Note that this message is preceded in the error log by a message for the 
same equipment which specifies the failing condition. 

EQ One of the following equipment types: 

CP 415 card punch 

CR 405 card reader 

LP 512 or 580 line printer 

LQ 512 line printer 

LR 580 line printer 

xx EST ordinal of local batch equipment 
yy Channel number 


EQxx, DNdn, DIRECT ACCESS FILE ERROR, AT nnn. 


PFM 


The system sector data for the file does not match the catalog data. 

xx EST ordinal of device 
dn Device number 


EQxx, DNdn, FILE LENGTH ERROR, AT nnn. 


PFM 


The length of a file does not equal the catalog length. 

xx EST ordinal of device 
dn Device number 
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Message 



EQxx, DNdn, MASS STORAGE ERROR AT nnn. 



EQxx, DNdn, RANDOM INDEX ERROR, AT nnn. 



EQxx, DNdn, REPLACE ERROR, AT nnn. 



EQxx, DNdn, TRACK LIMIT, AT nnn. 



I 



Routine 



PFM 



PFM 



PFM 



PFM 



Description 

The action taken depends on the type of command issued. 
Command Action 

GET A local file is created with length being the actual length 

retrieved. 
SAVE If file length is longer than TRT specification, file is 

truncated. 
REPLACE Same as for SAVE. 

An error was encountered in reading a portion of the permanent file catalog or 
permit information. 

xx EST ordinal of device 

dn Device number 

The random disk address of the permit sector is in error. 
xx EST ordinal of device 



dn 



Device number 



The same file was found twice during a catalog search. This error can occur for 
APPEND or REPLACE commands after a file is found and purged and the catalog 
search is continued. 



xx 

dn 



EST ordinal of device 
Device number 



No allocatable tracks remain on equipment xx. 



xx 

dn 



EST ordinal of device 
Device number 
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Message 


Routine 


Description 


EQxx, RM=mmmmmmm, PF=ppppppp, UI=iiiiii. 


PFM 


Additional line written only in error log after one of the following messages. 

EQxx, DNdn, DIRECT ACCESS FILE ERROR, AT nnn. 
EQxx, DNdn, FILE LENGTH ERROR, AT nnn. 
EQxx, DNdn, MASS STORAGE ERROR, AT nnn. 
EQxx, DNdn, RANDOM INDEX ERROR, AT nnn. 
EQxx, DNdn, REPLACE ERROR, AT nnn. 
EQxx, DNdn, TRACK LIMIT. AT nnn. 

xx EST ordinal of device 
mmmmmmm Family name 
ppppppp Permanent file name 
iiiiii User index 


EQUIPMENT NOT AVAILABLE 


LFM/RESEX 


Requested equipment is either in use or does not exist. 


ERASE LIMIT, fff AT nnn. 


1MT 


The system made 20 erasures (10 feet of tape) without being able to successfully 
write the tape. 


ERROR AT LINE xxx 




Issued when errors occur while resequencing a BASIC program. The line con- 
taining the error is specified by xxx. 


ERROR CODE xx, lfn AT addr. 


1MT 


1MT error code xx has occurred but no specific message is issued. This would 
normally not occur unless the job was dropped by the operator. 


ERROR IN ARGUMENTS 




One or more of the following conditions were detected. 

• More than one date was entered. 

• No options were selected. 

• The parameter was illegal or could not be recognized. 

• The TM option was selected but no data was specified. 

• Both the device number parameter and the packname or auxiliary device 
parameter were selected; auxiliary devices do not have device numbers. 


ERROR IN COMMAND PARAMETERS. 




Either no parameters are allowed or an illegal parameter has been encountered. 


ERROR IN DATE. 


PURGALL 


The format of the date (ad, md, or cd) parameter in a PURGALL request was 
incorrect. 


ERROR IN DEVICE NUMBER. 


PURGALL 


The file residency as specified by the device number parameter was illegal. 


ERROR IN DIRECTORY. 




Program library does not have a directory record or has an incorrectly for- 
matted directory record. 


ERROR IN FILE ARGUMENTS 


FILES 


The parameter could not be recognized. 
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Message 


Routine 


Description 


ERROR IN FILE CATEGORY. 


PURGALL/ 
PFILES 


The user specified an illegal file category. 


ERROR IN FILE TYPE. 


PURGALL 


The user specified an illegal file type. 


ERROR IN IDENTIFIER. 


PROFILE/ 
MODVAL 


PROFILE cannot recognize a directive identifier. The action taken depends upon 
the position of the erroneous identifier within the entry. 

• If the error occurs within a project number entry, the entire project 
number entry is disregarded. 

• If the error occurs in a directive that appears after a charge number but 
before the first project number, only the erroneous directive is disre- 
garded. However, if the error occurs on the first PN directive, the 
entire project number entry is disregarded. 

• If the error occurs in any PN directive except the first one, it is treated 
as an error within the preceding project number entry. Both the project 
number entry for the erroneous project number and the preceding project 
number entry are disregarded. 


ERROR IN ROUTE FUNCTION, LFN =filenam. 


DSP 


Informative message issued to the system dayfile stating an error occurred 
while routing filenam. 


ERROR IN LIMITS ARGUMENT. 




Parameters were included on the LIMITS statement. 


ERROR IN NUMERIC DATA. 


PROFILE/ 
MODVAL 


PROFILE detected nonnumeric data or numeric data exceeding the maximum limit 
for specified control value. The entire project number entry containing the 
erroneous directive is disregarded. 


ERROR IN PASSWOR ARGUMENTS. 




Parameters specified on a PASSWOR control statement were in error. 


ERROR IN PROFILE ARGUMENTS 


PROFILE 


Error on PROFILE control statement. 


ERROR IN TIME. 


PURGALL 


The format of the time parameter in a PURGALL request was incorrect. 


ERROR - FILE(S) NOT PROCESSED. 


CHKPT 


One or more files were not checkpointed because CHKPT detected address errors. 


FAST-ATTACH PROFILE FILE ILLEGAL. 


PROFILE 


Project file cannot be in fast- attach status on a reformat run. 


FET ADDRESS OUT OF RANGE AT nnn. 


CIO 


FET extends past job's field length. 


FET PARAMETER ERROR ON fff AT nnn. 


CIO 


One of the parameters in the FET is illegal or the FET is not long enough 
for the parameter. 


nnnn FILE DEQUEUED Dndn FMxxxxxxx. 


QREC 


Indicates the number of files that have been dequeued on the specified device. 

nnnn Number of files 
dn Device number 
xxxxxxx Family name 


FILE EMPTY. 


LFM/SFM/QFM 


The file specified was empty. 
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Message 


Routine 


Description 


FILE ERROR lfn. 


CHKPT/ 
RESTART 


An illegal address was detected on file lfn. 


FILE NAME ERROR. AT nnn. 


PFM 


File name contains illegal characters. 


FILE NOT FOUND 


LFM/SFM/QFM 


Requested file was not found. 


FILE NOT ON MASS STORAGE. 


3AD 


The specified file does not reside on mass storage. 


FILE NOT OVERLAY FORMAT. 


LDR 


The first record of the file was not an overlay. 


FILE TOO LONG, AT nnn. 


PFM 


The local file specified for a SAVE, REPLACE, or APPEND command exceeds 
the length allowed, or the direct access file specified for an ATTACH in WRITE, 
MODIFY, or APPEND mode exceeds the direct access file length limit for which the 
user is validated. 


FL BEYOND MFL. 


IMA 


Field length requirements for the job step exceed the field length allowed. 
The user will have to increase the job step field length. 


FL TOO SHORT FOR LIBRARY GENERATION. 


LIBGEN 


Additional memory is required for LIBGEN. 


FL TOO SHORT FOR PROGRAM. 


3AE 


The user's field length is too short for the program. 


FM NOT LEGAL FAMILY. 


PROFILE 


Illegal family name is specified with FM parameter. 


pfn FOUND, AT nnn. 


PFM 


The specified permanent file was found. 


FORMAT ERROR ON CONTROL CARD. 


TCS 


An error was detected in the format of the control statement. 


FORMAT ERROR ON OVERLAY DIRECTIVE 


LDR 


Illegal overlay directive parameter or no arguments found. 


FNT IS FULL. 


QFM 


The FNT filled during processing of the requeue function and all files could not be 
requeued. 


ILLEGAL ACCESS TO EXECUTE ONLY FILE. 


3AD 


The specified file is an execute-only file. 
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Message 



ILLEGAL CHARACTER NUMBER. 



ILLEGAL CHARGE. 

ILLEGAL COMMON MEMORY MANAGER REQUEST. 
ILLEGAL CONTROL CARD. 



ILLEGAL COUNT. 

ILLEGAL DEVICE REQUEST, AT nnn. 

ILLEGAL DISPOSE CODE. 
ILLEGAL EQUIPMENT. 

ILLEGAL EXTENSION OP fff AT nnn. 
ILLEGAL FILE NAME fff AT nnn. 
ILLEGAL FILE TYPE. 

pfn ILLEGAL FILE TYPE, AT nnn. 



Routine 



CHARGE 

IMA 
TCS/RESEX 



COPYBF/COPYBR/ 
COPYX 

PFM 



CIO 
CIO 

LFM/QFM 

PFM 



Description 

In a copy request, one of the following was detected. 

e Last character position was less than first character position. 

• Last character position was greater than 150. 

• Either first character position or last character position was unrecogniz- 
able. 

The specified charge or project number does not exist or the project number was 
not assigned to this user. 

Memory request with reserved bits in the parameter block were set incorrectly. 
One of the following: 

• The control statement could not be identified. 

• An invalid parameter was specified or no terminator was detected. 

• The user attempted to pass too many parameters on the program call 
statement (such as LGO). 

• The user submitted a control statement considered illegal because of his 
validation [for example, if access option 1 (refer to LIMITS control 
statement) was not set and the user submitted a PASSWOR control state- 
ment)]. 

• The user submitted a control statement considered illegal for a particular 
job t/pe or file type (for example, the use of a FAMILY statement in a 
nonsystem origin job). 

Number of files in copy request was either illegal or zero. 

The device type (r parameter) specified on a request for an auxiliary device cannot 
be recognized or does not exist in the system. 

If the auxiliary device specified by the pn parameter is not the same type as the 
system default, the r parameter must be included; if not, the message is issued. 

The queue type (q t ) specified on a DISPOSE control statement was unrecognizable. 

File is assigned to illegal equipment for the specific request (for example, the 
file specified in a COMMON request is not on mass storage). 

The user attempted to lengthen a file that could not be extended. 

The file name does not conform to established rules. 

The specified file is of a type not allowed in the requested operation. For example, 
this message would be issued if the file name in a RELEASE request was not a 
queue type file (input, print, or punch) or if the user attempted to make a non- 
local file a library file. 

The user attempted to DEFINE a local file residing on a device other than a 
permanent file device. 



CD 
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Message 


Routine 


Description 


ILLEGAL INPUT FILE. 


PACK 


An attempt was made to pack a file that is assigned to a time -sharing terminal. 
For example, file INPUT for time-sharing origin jobs represents data typed at 
the terminal keyboard, and therefore, cannot be packed. 


ILLEGAL I/O REQUEST ON FILE fff AT nnn. 


CIO 


CIO could not recognize the specified function code, or the code was not valid for 
the type of device to which the file was assigned. The system provides a dump on 
the FET on file OUTPUT. 


ILLEGAL LEVEL NUMBER. 


LDR 


One of the following: 

• Assembly error 

• Level number greater than 77 3 

• First overlay not zero level (0,0) overlay 


ILLEGAL LOAD ADDRESS. 


3AE 


The load address is less than 2. 


ILLEGAL MODIFICATION OF fff AT nnn. 


CIO 


Either the user has attempted to shorten a modify-only file or the file cannot be 
modified at all. 


ILLEGAL ORIGIN. 


SFM/QFM 


The origin type specified when releasing a local file to a queue was illegal. 


ILLEGAL ORIGIN SPECIFIED. 




Origin word count error. 


ILLEGAL PROFILE INQUIRE. 


PROFILE 


The user is not allowed to access the control information for the charge number 
supplied. 


ILLEGAL RECORD TERMINATION. 


COPYX 


Illegal format on record terminator. 


ILLEGAL SORT PARAMETER. 




The SORT control statement is in error. 


ILLEGAL TERMINAL REQUEST. 




A command intended for time-sharing origin jobs only (refer to Time-Sharing 
Commands, section 4) has been used in a non-time -sharing origin job. 


ILLEGAL USER ACCESS. 


,FM /QFM /QFSP /RESEJ 


1 User tried to perform an operation for which he was not validated. 


ILLEGAL USER ACCESS, AT nnn. 


PFM 


The user is not validated to create direct access or indirect access files or to 
access auxiliary devices. 


ILLEGAL USER CARD 


CPM 


User number or password could not be validated, or a secondary user statement 
was encountered while secondary user statements were disabled. 


IMPROPER ACCESSIBILITY. 


RESEX 


The user did not specify the correct file accessibility on the LABEL statement, or 
volume accessibility was set and a nonsystem origin user attempted to assign the 
tape as unlabeled. 


IMPROPER VALIDATION 


TCS 


A validation program (one containing a VAL= entry point, such as that used for 
CHARGE and USER) is required before continuing. 


INDEX ADDRESS OUT OF RANGE FOR fff AT nnn. 


CIO 


The random sector address for a random input/ output request was equal to or greater 
than field length. 


INPUT FILE IN NORERUN STATUS. 


QFM 


Informative message. 


INPUT FILE IN RERUN STATUS. 


QFM 


Informative message. 



Message 


Routine 


Description 


INQUIRY COMPLETE. 


MODVAL 


The inquiry was successfully completed. 


deckname-INVALID CS, 63 ASSUMED. 


TCS 


Character set identification for deck deckname was not recognizable. OPLEDIT 
assumes 63-character set and uses it for the new program library if one is being 
created. 


INVALID USER ACCESS - CONTACT SITE OPR. 


CPM. 1JA, 1LS 


The user number specified has exhausted its security count. The user 
number will be denied all access to the operating system until the security 
count has been reset by the operator. 


I/O ON EXECUTE-ONLY FILE fff AT- nnn. 


CIO 


The user attempted to read, write, or position an execute-only file. RETURN is 
the only operation allowed for an execute-only file. 


I/O SEQUENCE ERROR. 


QFM 


Action was requested by a busy file. 


I/O SEQUENCE ERROR, AT nnn. 


PFM 


A request was attempted on a local file that is currently active. This error can 
occur, for example, if the user creates two FETs for the same file and issues a 
second request before the first is completed. 


I/O SEQUENCE ERROR ON FILE fff AT nnn. 


CIO 


The user attempted to perform more than one concurrent function on a single file. 


JOB ABORTED, fff AT nnn. 


1MT 


The job was aborted while a tape operation was pending. 


JOB CARD ERROR. (20 characters) 


3AA 


The job statement on the file being submitted is in error. The first 20 
characters of the statement in error follow the message. 


JOB EXECUTING. 




The job is either executing or has been rolled out for a higher priority job. 


JOB IN INPUT QUEUE. 




Informative message. 


JOB IN NORERUN STATE ON RECOVERY. 


1AJ 


Identifies a job recovered on level deadstart that was aborted because it was in 
a no-rerun mode (due to NORERUN control statement or macro). 


JOB IN OUTPUT QUEUE. 




Informative message. 


JOB IN PUNCH QUEUE. 




Informative message. 


JOB NOT FOUND. 




This message normally indicates that the job has been processed and no longer 
exists in the system. However, it may also be issued if the jobname was entered 
incorrectly (misspelled). 


JOB STEP LIMIT. 


3AB 


The monitor detected the expiration of the job step SRU limit. 


JOB REPRIEVED. 


SFP 


The job has been successfully reprieved. 


LABEL CONTENT ERROR, fff AT nnn. 


1MT 


A block read was the correct size for a label but one or more required fields 
(such as the label name) were incorrect. The programmer should use the 
LISTLB control statement to determine the cause of the problem. 


LABEL MISSING, fff AT nnn. 


1MT 


During a read operation, a required label was missing. The programmer should 
use the LISTLB control statement to determine the cause of the problem. 


LABEL PARAMETER CONFLICT ON OPEN, fff AT nnn. 


1MT 


Label fields did not match on open request. An additional message 

FIELD BEGINNING AT nnn NO COMPARE, 
specifying the decimal character position in HDR1 of the first field that did not 
compare correctly is also issued. 
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Message 


Routine 


Description 


LBC ARGUMENT ERROR. 


CPMEM 


The load address, addr, specified on the LBC control statement was nonnumeric. 


LBC FWA .GE. FL. 


CPMEM 


The load address specified on the LBC control statement was greater than or 
equal to the user's field length. 


LDR ERROR. 


LDR 


Issued after one of the following errors.: 

OVERLAY NOT FOUND IN LIBRARY. 

ARG ERROR. 

FILE NOT OVERLAY FORMAT. 


LEVEL NUMBER MISSING 


LDR 




LFM ILLEGAL REQUEST. 


LFM 


One of the following: 

• LFM function detected was not recognized as a legal function. 

• An LFM function was issued without the auto recall bit set. 


LIBGEN ARGUMENT ERROR. 


LIBGEN 


An invalid parameter was used on the LIBGEN control statement. 


LIBRARY GENERATION COMPLETE. 


LIBGEN 


Informative message. 


LIBRARY GENERATION FILE EMPTY. 


LIBGEN 


The file to be processed is empty. 


LINE NUMBER LIMIT EXCEEDED. 


RESEQ 


The line number encountered or required during a resequencing (RESEQ) operation 
exceeded 99999. 


LOADER MISSING. 


TCS 


Either CALL or LDR= was not found in the library. 


LOC ARGUMENT ERROR. 


CPMEM 


The first word address or last word address parameter specified on the LOC 
control statement was nonnumeric. 


LOC RANGE ERROR. 


CPMEM 


Either the first word address was greater than the last word address or the last 
word address was greater than the user's field length. 


LOCAL FILE LIMIT, AT nnn. 


PFM 


The job's local file limit has been exceeded by an attempt to GET or ATTACH 
the file. 


LOCAL FILE LIMIT, FILE fff AT nnn. 


CIO 


The job's local file limit was exceeded in an attempt to define another file or 
attach an existing file to the job. 


LPxx, ... . 




Refer to the EQxx, . . . series of corresponding messages for full descriptions 
of messages beginning with LPxx,... . 


LQxx, ... . 




Refer to the EQxx, . . . series of corresponding messages for full descriptions 
of messages beginning with LQxx, ... . 


LRxx, .... 




Refer to the EQxx,... series of corresponding messages for full descriptions 
of messages beginning with LRxx, .... 
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Message 


Routine 


Description 


MASS STORAGE DIRECTORY NOT WRITTEN. 




On a GTR control statement, user requested that a mass storage directory record 
be written on a nonmass storage file. 


MASTER USER NUMBER REQUIRED. 


PROFILE 


Master user number must be present in control point area (set via USER 
control statement) for a master user list and for an enquire from other than 
system origin or special accounting user. 


MDxx, Cyy, ec, ann, Stttt, FNqqqq-r. 
or 


6MD 


An error has been detected on mass storage device xx. The nature of the error 
is determined by examining each parameter in the message. 


MDxx, Cyy, ec, ann, Stttt, Ux Cxxxx Stttt. 




xx EST ordinal of 841 disk 

yy Channel number 

ec Error code (one of the following): 

PE Parity error/checkword error 

AD Address error 

ST Device status error 

FN Function reject for any device connected to data 

channel converter (6681) or function timed out with 

no response 
RS Device reserved 
NR Device not ready 

a Type of operation (one of the following): 

R Read 

W Write 

nn Retry count; error is considered irrecoverable after the following 
number of retries. 

PE 10 

AD 10 

ST 64 

FN 10 

RS Indefinite 

NR Indefinite 

tttt Device status; implies there was an incomplete transfer if status 

does not indicate an error 
qqqq Function rejected 

r Data channel converter (6681) status, if present 
Ux Physical unit | 
Cxxxx Upper address 1 Physical address 
Sxxxx Lower address j 


MEMORY OVERFLOW. 




Insufficient storage was allowed for an OPLEDIT run. 


MESSAGE LIMIT. 


1AJ 


The number of messages issued by the job has exceeded the limit for which the 
user is validated. Message functions issued by compilers or applications programs 
that run at the user's job control point are also counted as user dayfile messages 
and thus are subject to the user's validated dayfile message limit. 


MFL REQUEST TOO SMALL, MINIMUM USED. 


CONTROL 


MFL request was less than CONTROL'S RFL= value. CONTROL'S RFL= 
value is used for this MFL request, thus allowing further MFL requests. 


MIXED CHARACTER SET OPL. 




Records of more than one character set were encountered on the old program 
library. 


MONITOR CALL ERROR 


1AJ 


RA+1 call unrecognized. 


MT. .. . 




Refer to the EQ, . . . series of corresponding messages for full description of 
messages beginning with MT. 
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Message 

M. T. NOT AVAILABLE ON FILE fff AT nnn, 
MT/NT CONFLICT 



MULTI-FILE NAME NOT FOUND fff AT nnn. 
NO CONNECT TIME AVAILABLE. 

NO CPU TIME AVAILABLE. 

NO DIRECTIVES. 

NO EOR FOUND ON ZZZZZDF. 



NO INPUT FILE FOUND. 

NO LINE NUMBER ON SORT FILE. 

NO LINE TERMINATOR. 

NON- MATCHING CONVERSION 

NO READ FILE - lfn. 

filename NOT DECLARED RANDOM. 

lfn NOT FOUND. 

NORERUN/ RERUN IGNORED FROM TTY JOBS. 

xxx NOT IN PP LIB, 



Routine 

CIO 

RESEX 



CIO 
CHARGE 

CHARGE 



QFM 
SORT 

COPYC 



SUBMIT 
LIBEDIT 

RESTART 
QFM/CONTROL 
SFP 



For example, a 



Description 

The magnetic tape executive is not executing. 

Conflict exists between 7-track and 9-track tape descriptors, 
request for a 9-track tape specifies 200-bpi density. 

This message can also be issued if the device type specified in FET+1 conflicts 
with the track type specified in FET+8, bit 56. If dt=MT and bit 56 is set, or if 
dt=NT and bit 56 is not set, the message is issued. 

User issued a *POSMF* on a nonexistent file on a multifile tape. 

The user has accumulated the maximum connect time allowed for the specified 
project number. 

The user has accumulated the maximum CPU time allowed for the specified project 
number. 

Directive file was empty. 

Illegal file format for ZZZZZDF. The FILE control statement (described in the 
Record Manager Reference Manual) is used to update the file information table 
(FIT) which is required for files the Record Manager accesses. The system uses 
information the programmer supplies on the FILE statement to prestore FIT in- 
formation in file ZZZZZDF. 



No valid input file exists; functions cannot be performed. 

A line on the input file to a SORT request is missing a line number or a line 
exceeded the 150-character limit. 

A copy operation was attempted on a line longer than 150 characters which did 
not contain a line terminator. 

The conversion mode required for the tape is not the same as that specified on the 
control statement. This is only a warning message. 

The specified file cannot be found. 

An EOF was encountered on the nonrandom file, filename. 



RESTART was unable to retrieve a file named, but not included, on lfn. 

User entered NORERUN/RERUN from a terminal. The command is ignored. 

PP package xxx was not found in PP libraries. 
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Message 


Routine 


Description 


xxx NOT IN PP LIB. - CALLED BY yyy. 


SFP 


PP package xxx was not found in the PP libraries and was called by package yyy. 


pfn NOT FOUND, AT nnn. 


PFM 


One of the following: 

• The specified permanent file could not be found. 

• The specified user number could not be found. 

• The user is not allowed to access the specified file. 

• The user issued an indirect access file command on a direct access file. 

• The user issued a direct access file command on an indirect access file. 

If this message occurs in response to the SAVE request, the specified local file 
is not attached to the control point, is a direct access file, or is an execute-only 
file. 


lfn NOT ON MASS STORAGE, AT nnn. 


PFM 


The file to be saved is not on mass storage; the first track of the file is not 
recognizable. 


NT.... . 




Refer to the EQ, ... series of corresponding messages for full description of 
messages beginning with NT. 


NO WRITE ENABLE, ON fff AT nnn. 


1MT 


Either the user attempted to write on a tape mounted with no write ring or no 
write was allowed because of additional constraints described in an additional 
message line. 

LABEL NOT The user attempted to write over a label that had 
EXPIRED. not yet expired. 

WRITE OVER The user is not allowed to destroy the VOL1 label. 
LABEL ILLEGAL. 

200 BPI WRITE The tape unit (667 or 669) does not support 200-bpi 
ILLEGAL. density. 


OLDPL ERROR. 


UPDATE 


Update program library format was bad. 


OPERATOR DROP. 


3AB 


The job was dropped by the operator. 


OPLEDIT COMPLETE. 


OPLEDIT 


Informative message indicating OPLEDIT completion. 


OPLEDIT ERRORS. 


OPLEDIT 


Errors were encountered while modifying a particular deck. 


OUTPUT FILE LIMIT 


LFM 


The total number of files disposed to the output queue by the job has exceeded the 
limit for which the user is validated. 


OUTPUT FILE LIMIT, FILE fff AT nnn. 


CIO 


During an attempt to close this file, the number of files disposed to output queues 
by the job has exceeded the limit for which the user is validated. 


OVERLAPPING INSERT OR DELETE. 




Insertions and deletions affect, the same deck. 


OVERLAY FILE EMPTY. 


3AD 


No data appears in the requested file. 


OVERLAY FILE NOT FOUND. 


3AD 
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Message 


Routine 


Description 


OVERLAY NOT FOUND. 


3AD/3AE 


The specified overlay was not found. 


OVERLAY NOT FOUND IN LIBRARY. 


LDR 


The specified overlay was not found in the system library. 


PACK PARAMETER ERROR. 


PACK 


The PACK control statement contains an error. 


PARITY ERROR - RESTARTED FROM kk. 


RESTART 


Because RESTART detected a parity error in attempting to restart from the 
specified checkpoint nn, the alternate checkpoint kk was used instead. 


PBC ARGUMENT ERROR. 


CPMEM 


Either the first word address or the last word address specified on a PBC control 
statement was nonnumeric. 


PBC FWA .GT. LWA. 


CPMEM 


The first word address was greater than the last word address. 


PBC RANGE ERROR. 


CPMEM 


The last word address parameter specified on a PBC statement was greater than 
or equal to the user's field length. 


PERMIT LIMIT EXCEEDED, AT nnn. 


PFM 


Permit limit for private file has been exceeded. 


PFM ABORTED, AT nnn. 


PFM 


Error flag detected at PFM control point. | 


PFM ILLEGAL REQUEST, AT nnn. 


PFM 


One of the following: 

• Illegal command code passed to PFM 

• Illegal permit mode or catalog type specified 

• CATLIST request has permit specified without a file name 

• PERMIT command attempted on a public file 


PF UTILITY ACTIVE, AT nnn. 


PFM 


Because a permanent file utility is currently active, the operation was not 
attempted; the user should retry the operation. 


PL ERROR IN DECK dname. 


MODIFY 


Error encountered in processing deck dname. 1 


POSITION ERROR ON— xxxxxxx. 




File xxxxxxx was not repositioned after being checkpointed because CHKPT de- 
tected an address error. 


POSITION LOST, fff AT nnn. 


1MT 


During write error recovery, the system could not find the last good block of data, 1 
making it impossible to successfully perform error recovery. 


PP CALL ERROR. 


3AB 


The monitor detected an error in a CPU request for PP action. 


PROFILE ABORTED. 


PROFILE 


Error flag is set at control point. 


PROFILE FILE CREATE COMPLETE. 


PROFILE 


Creation run is complete. 


PROFILE FILE DATA BASE ERROR. 


PROFILE 


Project file does not contain level and level 1 blocks. 


PROFILE FILE INQUIRY COMPLETE. 


PROFILE 


Enquire run is complete. 


PROFILE FILE LIST COMPLETE. 


PROFILE 


List run is complete. 


PROFILE FILE REFORMAT COMPLETE. 


PROFILE 


Reformat run is complete. 


PROFILE FILE SOURCE COMPLETE. 


PROFILE 


Source run is complete. 


PROFILE FILE UPDATE COMPLETE. 


PROFILE 


Update run is complete. 
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Message 


Routine 


Description 


PROGRAM FILE EMPTY. 


TCS 


A load of an empty data file was attempted. 




PROGRAM LIBRARY EMPTY. 




The old program library contained no data. 




PROGRAM NOT FOUND. 


EXU 


The program to be loaded was not found on the specified library file. 




PROGRAM NOT ON MASS STORAGE. 


EXU 


The program does not reside on a mass storage device. 




PROGRAM STOP AT xxxxxx. 


3AB 


The monitor detected a program stop instruction at address xxxxxx. 




PROGRAM TOO LONG 


EXU 


The program does not fit in the available storage. 




PROTECTED FILE 




The user has attempted to release a locked file. 




PRU LIMIT, AT nnn. 


PFM 


The job's mass storage PRU limit was exceeded during preparation of a local 
copy of an indirect access file. 




PRU LIMIT. FILE fff AT nnn. 
PRUS REQUESTED UNAVAILABLE. 


CIO 
3PF 


The job's mass storage PRU limit was exceeded during an attempt to write or 

extend this file. 

The number of PRUs requested is not available. 




PRUS REQUESTED NOT AVAILABLE, AT nnn. 


PFM 


The number of PRUs specified via the S parameter on the DEFINE request is 
available. 


not 


QFM ARGUMENT ERROR. 


QFM 


One of the following: 

• Address is outside field length 

• Address is equal to 1 

• Origin code is out of range 

• ID code is out of range 




QFM EOI BAD ON ATTACHED FILE. 


QFM 


The EOI sector cannot be found on the specified file. 




QFM FILE ALREADY ATTACHED. 


QFM 


The specified file is already attached to the control point. 




QFM FILE EMPTY. 


QFM 


The submitted file has not been used. 




QFM - FILE IGNORED filename. 


QFM 


The file was ignored because it had an illegal origin or type code. It could 
indicate a bad IQFT file. 




QFM FILE NAME ERROR. 


QFM 


The lfn specified does not check as a valid file name. 




QFM FILE NOT FOUND. 


QFM 


The submitted file could not be found. 




QFM FILE NOT ON MASS STORAGE. 


QFM 


The submitted file does not reside on mass storage. 




QFM ILLEGAL EQUIPMENT. 


QFM 


The equipment specified in FET+7 either is not mass storage or is not in the 
range of the EST. 




QFM ILLEGAL FILE TYPE. 


QFM 


The submitted file is not a local file. 




QFM ILLEGAL ID CODE. 


QFM 


The ID code is out of range. 




QFM ILLEGAL ORIGIN TYPE. 


QFM 


The origin type for the submitted file is not batch or Export/Import. 
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Message 


Routine 


Description 


QFM ILLEGAL REQUEST. 


QFM 


One of the following: 

• Specified function illegal or undefined 

• Job did not have SSJ= entry point 

• Auto recall bit was not set 


QFM INTERLOCK ERROR. 


QFM 


Track interlock could not be set due to a conflict. 


QFM TRACK MISMATCH. 


QFM 


The file about to be purged is not the same file that was previously attached. 
The first track in the FST does not equal the one from the DULL word. 


QFM UNABLE TO INTERLOCK MST. 


QFM 


Informative message. 


QUEUE FILE UTILITY COMPLETE. 


QFSP 


Informative message. 


QUEUED FILES LOST. 


QREC 


Files which process error conditions were not requeued. This error should never 
occur but may if QREC was aborted and could not modify its files correctly. A 
level deadstart will recover the queues. 


RA.SSC OUT OF RANGE. 


IMA 


The subsystem receiving the buffer pointer (RA.SSC) word has one or more 
fields outside the subsystem field length. 


RANDOM ADDRESS NOT ON FILE fff AT nnn. 


CIO 


The random address specified was not within the bounds of the file. The system 
provides a dump of the FET on file OUTPUT. 


READ AFTER WRITE, fff AT nnn. 


1MT 


The user attempted to read a tape on which the last operation was a write. 


READ FILE BUSY - lfn 


SUBMIT 


The read file is found to be busy (direct access file only). 


nnnnn RECORDS CONVERTED. 




Informative message indicating number of records (nnnnn) converted from one 
character set to another. 


n RECORD(S) NOT REPLACED. 


LIBEDIT 


Informative message; the job is aborted unless the D option was specified. 


RECORD SIZE EXCEEDS 500. 




The maximum line length for a record to be converted (500 characters) was 
exceeded. 


RECORD TOO LONG. 


CPMEM 


The record is too long for available memory. Available memory is filled and the 
excess data is skipped. In response to a WBR request, the record length 
parameter was greater than or equal to the user's field length. 


REPRIEVE IMPOSSIBLE - BAD CHECKSUM 


SFP 


Postrecovery checksum does not match prerecovery checksum. 


REQUEST UNDEFINED ON DEVICE fff AT nnn. 


CIO 


The specified function cannot be performed on the device on which the file resides. 
The system provides a dump on the FET on file OUTPUT. 


REQUESTED FL BEYOND MFL 


IMA 


The job's memory request has exceeded the maximum field length for 
a job step. 


RERUN NOT POSSIBLE. 
RESEX DETECTED ERROR. 


IDS 
LFM 


Operator attempted to rerun a job that is in no-rerun mode. 
The resource executive (RESEX) detected an error. 
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Message 


Routine 


Description 


RESEX FAILURE, AT nnn. 


PFM 


The resource executive (RESEX) has detected a fatal error. 


RESOURCE DEMAND ERROR. 


RESEX 


The user attempted to decrease the number of scheduled units to less than the 
number of currently assigned units or increase the number of scheduled units 
to a point where a deadlock would occur. 


RESOURCE TYPE ERROR. 


RESEX 


The user specified an illegal resource type. 


jobname RESTARTED FROM yy/mm/dd. hh. mm. ss. 


RESTART 


The checkpointed job identified by jobname was restarted from the checkpoint 
taken on the specified data and time. This message is issued whenever a check- 
point job is restarted. 


RFL BEYOND MFL. 


CPM 


The RFL request is greater than the maximum field length for a job step. 


ROLLIN FILE BAD. 


1RI 


An illegal format was detected in the roll-in file. 


ROUTE CONTROL CARD ERROR. 


ROUTE 


Format of the control statement is incorrect. 


ROUTE *DC* INCOMPATIBLE WITH *EC*. 


ROUTE 


The user specified a DC/EC combination that is not legal. If the DC 
parameter implies a print file, the EC parameter must be for print files. 


ROUTE ILLEGAL KEYWORD. 


ROUTE 


Control statement contains an illegal keyword. 


ROUTE ILLEGAL *OT* PARAMETER. 


ROUTE 


The origin type specified by the OT parameter is illegal. 


ROUTE *OT* NOT ALLOWED. 


ROUTE 


The user program is not system origin. Only system origin jobs can use 
the OT parameter. 


ROUTE #REP* GT 31. DEFAULT USED. 


ROUTE 


The repeat count specified was greater than 31; it has been set to 0. This 
condition will not abort the program. 


ROUTE *TID* AND *FM/UN* CONFLICT. 


ROUTE 


The TID parameter was specified with either the FM or UN parameter. 
Either one of these parameters is mutually exclusive with TID. 


ROUTE *TID/FM/UN* and *ID* CONFLICT. 


ROUTE 


The ID parameter was specified with the TID or FM or UN parameter. 


ROUTE *FID* IGNORED. 

ROUTE *PRI* IGNORED. 

ROUTE *ST* IGNORED. 

ROUTE *TlD=xx - VALUE IGNORED.* 


ROUTE 
ROUTE 
ROUTE 
ROUTE 


Informative message listed for NOS/BE compatibility. 
Informative message listed for NOS/BE compatibility. 
Informative message listed for NOS/BE compatibility. 
Informative message listed for NOS/BE compatibility. 


ROUTE COMPLETE. 

ROUTE COMPLETE. JOB NAME IS FILnam. 




Issued when route is complete. 
Issued when route is complete. 
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Message 


Routine 


Description 


SECURE MEMORY, DUMP DISABLED. 


1AJ 


An attempt was made to dump memory protected by the system. 


SFM ARGUMENT ERROR. 


SFM 


The argument passed to SFM was out of bounds or the FET specified did not 
specify a buffer of at least 100 g words. 


SFM DAYFILE BUSY. 


SFM 


Action was requested on a busy dayfile. 


SFM ILLEGAL DAYFILE CODE. 


SFM 


The dayfile code passed in the FET was not within range. 


SFM ILLEGAL REQUEST. 


SFM 


The requested function or origin type specified in the function call was not 
recognizable or SFM request was made and the auto recall bit was not set. 


SFM TRACK INTERLOCK ERROR. 


SFM 


Track was either interlocked when it should not have been or not interlocked when 
it should have been. 


SL NOT VALIDATED. 


CPM 


The SRU limit requested exceeds that for which the user is validated. 


SMF UNABLE TO INTERLOCK DEVICE. 


SFM 


SFM request was not performed because the selected device could not be inter- 
locked. 


SFP CALL ERROR. 


SFP 


SFP was not loaded by default. 


SFP/RPU UNABLE TO RESET, NOT REPRIEVED. 


SFP 


An attempt was made to reset when the job had not been reprieved. 


SFP. xxx ILLEGAL ORIGIN CODE. 


SFP 


Function illegal for user's job origin. 


SFP/xxx PARAMETER ERROR. 


SFP 


Parameter address outside FL. 


SPCW CALL ERROR. 


1AJ 


A DMP= type call was made, and the program called is either not in the CLG 
or does not have a DMP= entry point defined. 


SPECIAL REQUEST PROCESSING ERROR. 


SFP 


The SPCW word was busy. 


STATUS ERROR, fff AT nnn. 


1MT 


An irrecoverable error was encountered. A second message line describes the 
error in more detail. 

CRC ERROR. An error was detected in cyclic redundancy character. 

DATA TIMING Hardware malfunctions. Another unit should be tried. 

PROBLEMS. 

FILL STATUS The system has detected an odd number of frame, a 

ILLEGAL. condition which is illegal for the data format of the 

tape being read. 
FLAG BIT ERROR. The tape being read with ASCII conversion contains 

characters not included in the 128-character set. 
MEMORY PARITY A parity error was detected in the conversion memory 
ERROR. of the tape controller. 

MULTI-TRACK Multiple tracks were found to be in error at 1600 cpi, 
PHASE ERROR. making recovery impossible. 
PARITY ERROR. The tape could not be read/written correctly. 
UNIT HAS MOTION The tape unit cannot properly write the tape. The 
PROBLEMS. user should resubmit his job, using a different tape 

unit. 
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Message 


Routine 


Description 






POSTAMBLE A missing or defective postamble was detected at 

ERROR. 1600 cps. 

SINGLE FRAME A frame (NRZI only) containing all zeros was read; 

ERROR. data will be at least one frame short. 

LRC ERROR. The longitudinal redundancy check character was 

read incorrectly (9-track NRZI). 
ILLEGAL Illegal character read from 9-track tape. If a 1 is 
CHARACTER. detected in bit 6 of a translated character, the 

character is illegal. 
IBG NOT FOUND - False read end-of-operation occurred, and the IBG 
POSITION could not be located within 100 inches. Further 
UNCERTAIN. positioning is uncertain. 


SUBSYSTEM ABORTED. 


3AB/1AJ 


The user job was connected (either long term connection or wait response set) to 
a subsystem which aborted. 


SYSTEM ABORT. 


1AJ 


Possible errors include detection of a bad rollout file by 1RI, an unrecognizable 
error flag, an SSJs block outside a field length, or an invalid USER statement. 


SYSTEM SECTOR ERROR. 


QFM. 


An error occurred while reading the system sector. 


TABLE OVERFLOW. 
JOB ABORTED. 




Resubmit job with increased field length. 


TAPE BLOCK DEFINITION ERROR. 


RESEX 


The user attempted to define data block size via the FC or C keyword or noise 
block size via the NS keyword in such a manner that the system is unable to 
correctly define the size of the data block. The omission of the FC or C param- 
eter on a control statement where it is required also causes this message to be 
issued. 


TAPE FORMAT PROBABLY WRONG. 


1MT 


This message is issued in addition to one of the following messages. 

BLOCK SEQUENCE ERROR, fff AT nnn. 
BLOCK TOO LARGE, fff AT nnn. 
WRONG PARITY, fff AT nnn. 

if one of these error conditions occurs on the first block. 


TIME LIMIT. 


3AB 


The monitor detected that the time limit for the job step has expired. 


TL NOT VALIDATED. 


ACCFAM 


The time limits specified on the job statement exceed that for which the user is 
validated. 




CPM 


The time limit requested exceeds that for which the user is validated. 
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Message 


Routine 


Description 


TOO MANY ARGUMENTS. 


TCS 


The number of arguments on the control statement exceeds that allowed by the 
program. 


TOO MANY ARGUMENTS. 


COPYB 


More arguments were specified on a copy request than are allowed on that 
statement. 


TOO MANY DEFERRED BATCH JOBS. 


QFM 


The user is not validated for this function or he has more jobs in the system 
than he is allowed. (All jobs in batch queues and E/I queues are counted.) 
The count is ignored if the job is of system origin or the user is validated for 
system privileges and DEBUG mode is set by the operator. 


TRACK ALREADY ASSIGNED 


QFM 


The track byte for the IQFT file in the DULL word in the MST is already assigned. 


TRACK LIMIT, FILE fff AT nnn. 


CIO 


The device on which the file resides is full. 


UNABLE TO READ IQFT FILE. 


IMS/MSI 


An attempt to initialize inactive queues failed because the IQFT file could not be 
read. 


UNIDENTIFIED PROGRAM FORMAT. 


3AE 


The file the user requested to be loaded was not in a recognizable format. 


UNRECOVERABLE MS ERROR. 


QFM 


An irrecoverable mass storage error was detected during an I/O operation. 


UPMOD COMPLETE. 


UPMOD 


Informative message indicating UPMOD completion. 


VERIFY ERRORS. 


VERIFY 


Errors were encountered during VERIFY routine. 


WBR ARGUMENT ERROR. 


CPMEM 


The record length parameter specified on a WBR statement was nonnumeric. 


WRITE ON READ-ONLY FILE fff AT nnn. 


CIO 


Either the user attempted to write on a file with write interlock or the direct 
access file was not attached in WRITE mode. 


WRITE OVER LABEL ILLEGAL ON fff AT nnn. 


1MT 


The user is not allowed to destroy the VOL1 label. 


WRONG PARITY, fff AT nnn. 


1MT 


A 7-track tape is being read in opposite parity from which it was written. 


25555 FIELD LENGTH INCREASE, 


LIBEDIT 


The job field length was too small for LIBEDIT. Field length was increased 
to 26K. 



o 

CO 
Ul 

o 
o 

o 



LFM ERROR CODES 

The following octal error codes are returned to the error code field of the FET word I 
0, bits 10 through 13 in response to LFM requests. 

Error Codes Description 



1 File not found 

2 File name error 

3 Illegal file type 

4 File empty 

6 Duplicate common file name 

7 Illegal equipment 

10 Equipment not available 

11 Duplicate file name 

12 Illegal user access 

13 Illegal user number 

14 Illegal ID code 

15 Resource executive (RESEX) detected an error 

16 I/O sequence error 

17 Output file limit 

20 Local file limit 

21 No mass storage available 

22 Illegal file mode 

23 FET too short 

24 GETFNT table too large 

25 Illegal change in file /origin type 
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PFM ERROR CODES 

The following error codes are returned to the error code field of the FET word 0, bits 
| .17 through 10 in response to PFM requests. 

Error Codes Description 

1 The specified direct access file is attached in the opposite 
mode. 

2 One of the following: 

The specified permanent file could not be found. 

The specified account number could not be found. 

The user is not allowed to access the specified file. 

The user issued an indirect access file command on 
a direct access file. 

The user issued a direct access file command on an 
indirect access file. 

If this message occurs in response to the SAVE macro, the 
specified local file is not attached to the control point, is a 
direct access file, or is an execute-only file. 

3 The file specified on a SAVE macro contains no data. 

4 The file to be saved is not on mass storage; the first track 
of the file is not recognizable. 

5 The user has already saved or defined a file with the name 
specified. 

6 The user attempted to define a file that was not a local file. 

7 File name contains illegal characters. 

10 The user is not validated to create direct access or indirect 
access files or to access auxiliary devices. 

11 The device type (r parameter) specified on a request for an 
auxiliary device cannot be recognized or does not exist in 
the system. 

If the auxiliary device specified by the pn parameter is not 
the same type as the system default, the r parameter must 
be included; if not, this message is issued. 
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Error Codes Description 



12 The local file specified for a SAVE, REPLACE, or APPEND 
command exceeds the length allowed, or the direct access 
file specified for an ATTACH in WRITE, MODIFY, or 
APPEND mode exceeds the direct access file length limit 
for which the user is validated. 

13 One of the following: 

• Illegal command code passed to PFM 

• Illegal permit mode or catalog type specified 

• CATLIST request has permit specified without a file 
name 

• PERMIT command attempted on a library file 

14 Access to the permanent file device requested is not possible. 

15 The device on which the file resides may not contain direct 
access files because: 

1. The device is not specified as a direct access de- 
vice in the catalog descriptor table. 

2. The device is not specified as ON and initialized 
in the catalog descriptor table. 

3. The device is a dedicated indirect access perma- 
nent file device. 

16 Because a permanent file utility is currently active, the 
operation was not attempted; the user should retry the oper- 
ation. 

17 An error occurred in a read operation during a file trans- 
fer. 

20 The number of files in the user's catalog exceeds the limit 

(refer to LIMITS control statement, section 6). 

21 The cumulative size of the indirect access files in the user's 
catalog exceeds the limit (refer to LIMITS control statement, 
section 6). 
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Error Codes Description 

22 The number of PRUs specified via the S parameter on the 
DEFINE macro is not available. 

23 A request was attempted on a local file that is currently 
active. This error can occur, for example, if the user 
creates two FETs for the same file and issues a second 
request before the first is completed. 

24 The job's local file limit has been exceeded by an attempt 
to GET or ATTACH the file. 

25 The job's mass storage PRU limit has been exceeded during 
preparation of a local copy of an indirect access file. 

26 Permit limit has been exceeded for a private file. 

30 The resource executive has detected a fatal error. 

31 No allocatable tracks remain on equipment xx, where xx is 
the EST ordinal. 

32 The length of a file does not equal the catalog length; the 
action taken depends on the type of command issued. 

Command Action 

GET A local file is created with length 

being the actual length retrieved. 

SAVE If file length is longer than TRT 

specification, file is truncated. 

REPLACE Same as for SAVE. 

33 Permit random address error. 

34 The system sector data for the file does not match the 
catalog data. 

35 The same file was found twice during a catalog search. 
This error can occur for APPEND or REPLACE commands 
after a file is found and purged and the catalog search is 
continued. 

36 Error flag detected at PFM control point. 

37 An error was encountered in reading a portion of the 
permanent file catalog or permit information. 

Table 1-B-l specifies the action PFM takes if it detects an error while reading mass 
storage. The symbols used in the table designate the type of response PFM makes 
and are defined as follows: 

Symbol Description Code 



DTE DATA TRANSFER ERROR. 17 

EOI Processing continues as if an EOI was encountered. 

MSE MASS STORAGE ERROR. 37 

FNF pfn NOT FOUND. 2 

DAF DIRECT ACCESS FILE ERROR. 34 

FLE FILE LENGTH ERROR. 32 

l-B-36 60435400 C 
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T 


ABLE 1 


-B-l. PERMANENT 


FILE ERROR CONDITIONS 








Command 


Activity 


SAVE 


GET 


PURGE 


CATLIST 


PERMIT 


REPLACE 


APPEND 


DEFINE 


ATTACH 


Device-to-device 
transfer (valid 
sector) 


DTE 


DTE 








DTE 


DTE 






Device-to-device 
transfer (no valid 
sector) 


EOIt 


EOIt 








EOIt 


EOIt 






Reading PF catalog 


MSE 


FNF 


FNF 


EOI 


FNF 


MSE 


FNFt t 


MSE 


FNF 


Device-to-device 
transfer of original 
file (valid sector) 














DTE 






Device-to-device 
transfer of original 
file (no valid sector) 














EOIt 






Reading a system 
sector 






DAF 










DAF 


DAF 


Reading permit 
information 




FNF 


FNF 


EOI 




FNF 


FNF 




FNF 


Reading permit 
information for 
update 




MSE 






MSE 


MSE 


MSE 




MSE 


t Unless the error occurred while the last sector was being read, a FILE LENGTH ERROR message is issued, 
t f If the error occurred on a reentrant search of the PF catalog, a MASS STORAGE ERROR message is issued. 
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LIBEDIT 



LIBEDIT is a binary record management program that is used to: 

• Create and maintain a program library file 

• Copy records to a program library file 

• Delete records from a program library file 

• Replace records on a program library file 

Binary logical records are the basic unit manipulated. LIBEDIT manipulates the records 
of the old program library file and optional replacement files. Records for replacement 1 
can be on one or more secondary files. Replacement is the implicit mode of a LIBEDIT 
run. Additions and no- replacements must be explicitly requested. 

LIBEDIT manipulates the following record types. 

« Relocatable central processor program (RED 



Central processor overlay (OVL) 

Multiple entry point overlay (ABS) 

6000 peripheral processor program (PP) 

7600 peripheral processor program (PPU) 

Modify old program library deck (OPL) 

Modify old program library common deck (OPLC) 

Modify old program library directory (OPLD) 

User library programs (ULIB) 

Unrecognizable as a program (TEXT) 

CAP capsule loader record (Supported by CDC CYBER Loader 1.3) 



Formats are further described in appendix G, volume 2. 



LIBEDIT executes in two phases. During the first phase, it reads directives and re- 
placement records. It groups directives by type and file and groups corrections when 
several insertions take place relative to the same record. 

During the second phase, LIBEDIT performs modifications and generates the new program | 
library. If LIBEDIT cannot process the specified combination of directives, and the D 
option (refer to the following control statement description) was not specified, LIBEDIT 
lists the conflicting directives (or a simulated form of the directives), issues an error 
message, and aborts the job. If the D option was specified, LIBEDIT continues processing 
the directives. 
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CONTROL STATEMENT FORMAT 

The following control statements call the LIBEDIT program to be loaded and executed. 
Parameters specify mode and files. 

LIBEDIT(p 1 ,p 2 ,...,p n ) 

The optional parameters, pi, can be in any order within the parentheses. Generally, a 
parameter can be omitted or can be in one of the following forms. 

a (C, R, and V only) 

a=lfn 

a = 

a is one of the following options: I, P, N, L, LO, B, C, R, and V. lfn is the 1- to 
7- alphanumeric character file name. LIBEDIT accepts only one instance of any param- 
eter. 

Option Description 



I=lfn 

1=0 

I omitted 

P=lfn 

P=0 

P omitted 

N=lfn 

N=0 

N omitted 



L=l 

L=0 

L omitted 



LO=lfn 

LO omitted 

B=lfn 

B=0 

B omitted 



C omitted 



R 

R omitted 

V 

V omitted 

D 

D omitted 
l-C-2 



Directives comprise the next record on file lfn 
No directive input 
Directives are on file INPUT 

File lfn contains the old program library 

No old program library file 

Old program library is on file OLD 

New program library will be written on file lfn 
Illegal; no error message is issued, if used 
New program library will be written on file NEW 



NOTE 



The new program library is evicted 
prior to processing (refer to EVICT 
statement, section 7). 

Short correction listing (includes only directives, modifications, 

and errors) on the file specified by the LO parameter 

No output is listed 

Full correction listing is written on the file specified by the LO 

parameter 

List output on file lfn 

List output on file OUTPUT 

Use file lfn for the replacement file 

Do not use a default replacement file 

Use file LGO as the default replacement file 

Copy the new library file over the old library file after processing 
Do not copy the new library file over the old library file after 
processing 

Do not rewind library files after processing 

Rewind old and new library files after LIBEDIT and VFYLIB 

processing 

Call VFYLIB after LIBEDIT processing 

Do not call VFYLIB to verify libraries after LIBEDIT processing 



Ignore errors and continue 

Do not ignore errors; abort job 
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LIBEDIT DIRECTIVES 

Directives comprise a program record on file INPUT or on the file specified through the 
I mode parameter on the LIBEDIT control statement. Directives control the record manage- 
ment process. A directive begins with an asterisk in column 1 followed immediately by the 
statement identifier. The statement identifier is delimited by a comma and /or one or more 
spaces. Parameters are delimited by -, a blank, an end-of-line, or a comma. 

Statement parameters have no embedded blanks. If a directive does not begin with an 
asterisk and a statement identifier, LIBEDIT assumes the operation is a continuation of the 
last directive operation. If the statement was not preceded by a directive, the operation is 
assumed to be: 

♦BEFORE *,gid r gid 2 ,...,gid n . 

Note, however, that gid entries cannot be split between statements. For example, the state- 
ments 

*B, OVL/P1, OVL/P2, . . . , OVL/P 

N 

do not constitute a valid directive. The last entry would not be processed as OVL/PN. 
On the other hand, the statements 

*B,OVL/Pl,OVL/P2 

OVL/P3 

OVL/PN 



TEXT/T1 

do constitute a valid directive and would be processed in the same manner as: 

*B,OVL/Pl,OVL/P2, OVL/P3, OVL/PN, 0, TEXT /Tl 

Directives are not required. If they are not provided, LIBEDIT replaces the records 
of the old program library file that have the same name and type as the records on the 
correction file, and LIBEDIT writes the new library. 

Parameters common to many of the correction directives are the reference record 
identifier (rid) and the group record identifier (gid). 

rid The rid parameter specifies a reference point for a correction. It can 

be in one of the following forms. 

type/rname Reference record is of the specified type 

rname Reference record is the implied type (refer to type) 

* Reference point is an end-of-file mark (^BEFORE 

card only) 

gid One or more gid parameters on a directive indicate records or groups 

of records to be inserted, deleted, or replaced. A gid can be in one 
of the following forms. 

type/rname Single record of the specified type 

type ^/ rname ]_- Group of records beginning with rname of type^ and 
type2/rname2 ending with rname2 of type2» Types are specified 

or implied. 

rname Record identifier can be one of the following. 

rname N Name of record 
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type 



LIBEDIT recognizes the following directives, 
Directive 



* If used for rname. on an 

INSERT, AFTER, BEFORE, 
or IGNORE, an * indicates 
that all records on the library 
of the specified or implied 
type are to be inserted or 
ignored. 

If used for rname2 on INSERT, 
AFTER, BEFORE, or IGNORE, 
an * indicates that all records 
of typei, starting with rname-^, 
are to be inserted or ignored. 

Indicates that a zero-length 

record is to be inserted. 

Identifies the type of the named record. When 
type is absent from a rid or gid parameter, 
LIBEDIT uses the type most recently speci- 
fied on a directive. For valid types, refer 
to the description of the TYPE directive. 



Definition 



♦ADD 

♦BEFORE or *B 

♦BUILD 

♦COMMENT 

♦ COPY 

♦DATE 

♦DELETE or *D 

♦FILE 

♦IGNORE 

♦INSERT or *I 
♦AFTER or *A 

*NOREP 

♦RENAME 

♦REPLACE 

♦REWIND 
♦TYPE or NAME 



or 



Adds records at end of library. 

Inserts records before the named record. 

Builds an index at end of new file. 

Adds comment to prefix table. 

Copies new file to old at end of editing. 

Adds date and comment to prefix table. 

Deletes specified records. 

Declares additional correction file. 

Ignores records when reading correction file. 

Inserts records from correction file after named record. 

Does not automatically replace records from named file. 

Renames record. 

Replaces records on old file with records from correction file. 
Optionally declares current correction file as no -replace. 

Designates file to be rewound before and after editing. 

Sets type of library to be used for default. 
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FILE 

The directive format is: 

*FILE lfn 

lfn Name of the additional replacement file; subject to operating system 

restrictions on file names. If lfn is an *, LIBEDIT uses the re- 
placement file specified by the LIBEDIT statement or the default 
file (LGO), if none is specified. 

The FILE directive declares a secondary file as an additional file that contains replace- 
ment records. LIBEDIT directives following a FILE statement specify records on the 
declared replacement file. 

REWIND 

The directive format is: 

♦REWIND lfn 

lfn Name of file to be rewound 

LIBEDIT rewinds the specified file before and after editing. 

TYPE OR NAME 

The formats for the directives are: 

♦TYPE type 
♦NAME type 

type Specifies default type of internal record format: 

ABS Multiple entry point overlay 

CAP Capsule loader record (Supported by CDC CYBER Loader 1.3) 

OPL Modify old program library deck 

OPLC Modify old program library common deck 

OPLD Modify old program library directory 

OVL CPU overlay 

PP 6000 series format peripheral processor unit program 

PPU 7600 format peripheral processor unit program 

REL Relocatable CPU program 

TEXT Unrecognizable as a program 

ULIB User library program; begins with a ULIB type record 

and terminates with OPLD type record 

Any explicit use of a type or a rid or gid parameter resets the default value to the new 
type. 

With the TYPE (or NAME) directive, the user specifies the type of record to which sub- 
sequent LIBEDIT directives refer. A type specification is in effect until the next TYPE 
(or NAME) directive is supplied or until a type is explicitly declared on another directive. 
If no TYPE or NAME directive is supplied or no explicit type is used, the type is TEXT. 
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For example : 

/*BEFORE *, JANE-* 



* DELETE HENRY -IDA 



Ji 

X*INSERT GEORGE, MARY 
/*TYPE REL 
is equivalent to 



/*BEFORE *, REL/JANE-* 
/* DELETE REL/HENRY-REL/IDA 
/*INSERT REL /GEORGE, REL/ MARY 



INSERT OR AFTER 

The formats for the directives are: 

^INSERT ri^gid^gidg, ...,gid n or *I rid,gid x , gid g , . . . , gid R 

*AFTER rid, gid^ gid 2 , . . . , gid n or *A rid, gid^ gid 2 , . . . , gid n 

rid Identifies the record on the old library file after which the 

specified records or groups of records are to be inserted 

gidj Identifies the records or groups of records from the replacement 

file to be inserted after rid 

An INSERT or AFTER directive directs LIBEDIT to insert records or groups of records 
from the current replacement file after the specified old library record for transcription 
to the new library file. The current replacement file is the most recent file specified 
by a FILE directive or by the LIBEDIT control statement. Insertion of records causes 
automatic deletion of the old records having the same names and types from the old 
library file. 

An example of the use of this directive is: 
^INSERT OPL/LEA, TEXT/OSCAR-* 

These statements direct LIBEDIT to insert, after the OPL deck LEA on the old library 
file, all TEXT records from OSCAR until an end-of-file mark is encountered. If any 
of these TEXT records have the same name as a TEXT record that is already on the 
old library file, the old TEXT record is not transcribed to the new library file. 
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BEFORE 

The directive formats are: 

*BEFORE rid,gidpgid 2 , . . . ,gid n or *B rid, gidp gid 2 , . . . , gid n 

rid Identifies the record on the old library file before which the 

specified records are to be inserted. On the form omitting the 
directive name, rid is assumed to be * (that is, insert before 
end-of-file). 

gidj[ Identifies records or groups of records from the replacement 

file to be inserted before rid. 

A BEFORE directive causes LIBEDIT to insert records or groups of records from the 
current replacement file before the specified old library record for transcription to the 
new library file. The current replacement file is the most recent replacement file 
specified by a FILE directive or by the LIBEDIT control statement. Insertion of records 
causes automatic deletion of the old records having the same names and types from 
the old library file. 

DELETE 

The directive formats are: 

^DELETE gid 1 ,gid 2 , . . . ,gid n or *D gid^ gid 2 , . . . , gid n 

gid. Identifies records or groups of records to be deleted from the 

old library file. An asterisk cannot be used. 

The DELETE directive causes LIBEDIT to suppress copying of the specified records 
from the old library file to the new library file. 

An example of the use of this directive is: 
♦DELETE PPU/LAD-REL/RUN 

This statement directs LIBEDIT to delete records starting with 7600 PPU program LAD 
through relocatable CPU program RUN. 

IGNORE 

The directive format is: 

♦IGNORE gidp gid 2 , .... gid n 

gid^ Identifies records or groups of records from the replacement file 

to be ignored. 

The IGNORE directive causes LIBEDIT to ignore a record or group of records on the 
current replacement file during record processing. 

An example of the use of this directive is: 

♦IGNORE FRAN-*' 
♦FILE WOMAN 

LIBEDIT ignores program FRAN of the current type and all following programs of the 
current type until an end-of-file mark on the replacement file WOMAN is encountered. 
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ADD 

The directive format is: 
*ADD Hb,gid 1 ,gid2, 
lib 



..-.gidn 

Specifies that the library is to be added to the old program library- 
file before the zero-length record for the old library file indicated. 
A library cannot be added if there is no zero-length record. 

LIB1 to 
LIB63 



Libraries 1 through 63 on the old program library file. 



gidj 



Identifies records or groups of records to be added to the speci- 
fied library. 



The ADD directive causes LIBEDIT to append records to the specified library for tran- 
scription to the new library. Two libraries are separated by a zero-length record on the 
new library file. 

1 NOTE 



Directories are determined from file OLD; adding 
a zero-length record does not change the directory 
of the library being added. 

Figure 1-C-l illustrates where records are inserted with the ADD directive. 
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Figure 1-C-X. Adding to the Old Program Library 
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BUILD 

The directive format is: 

♦BUILD dname 

dname Name of directory record. 

The BUILD directive requests LIBEDIT to construct and append a directory record in Modify 
format to the new library file. If the old library file has such a directory, LIBEDIT 
automatically generates a new directory deck without an explicit BUILD request.! 

COMMENT 

The directive format is: 

♦COMMENT rid comment 

rid Name of the record on the replacement or old library file. 

comment A string of up to 40 «q characters that is suitable as a comment. 

Additional characters are truncated. 

The COMMENT directive adds a comment to the prefix (77) table for a program on a replace- 
ment file or the old library file. If the program previously did not have a prefix table, 
LIBEDIT generates one that includes the date and the comments. 

DATE 

The directive format is: 
♦DATE rid comment 

rid Name- of the record on the replacement or old library file. 

comment A string of up to 40^q characters that is suitable as a comment. 

Additional characters are truncated. 

The DATE directive adds the current date and the specified comment to the prefix (77) table 
for a program on a replacement file or the old library file. 

NOREP 

The directive format is: 

♦NOREP lfni, lfn 2 , . . . , lfn n 

The NOREP directive declares the specified replacement files to be no-replace files. LIBEDIT 
does not replace all records of the old library file with records on the no -replace file 
having identical names but selectively replaces records from a no-replace file according 
to REPLACE, INSERT, and BEFORE directives. 



t BUILD can also be used to change the directory name. 
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RENAME 

The directive format is: 

-RENAME rid, name 

rid Name of the record on the replacement or old library file to be 

renamed. 

name New name of the record (1 to 7 characters). 

The RENAME directive assigns a new name to a record on the old library or the current 
replacement file for transcription to the new library file. If the renamed record is 
referenced by another correction statement in the same run, the old name should still 
be used. 

REPLACE 

The directive format is: 

*RE PLACE gid 1 ,gid 2 ,...,gid n 

gid^ Name of the record or record group from the replacement file 

to replace on the old library file. 

The REPLACE directive directs LIBEDIT to selectively replace records on the old library 
file with records of the same name from a current replacement file that has been de- 
clared a no-replace file (refer to the NOREP statement description). Thus, the user can 
selectively replace records by using the NOREP and REPLACE directives, or he can 
selectively not replace records by using the IGNORE directive according to the circum- 
stances. 

An example of the use of this directive follows: A user has a replacement file named 
FRUIT containing records APPLE, CHERRY, GRAPE, and ORANGE. Records having the 
same names are on the old library file. The user wishes to retain records APPLE and 
CHERRY but replace records GRAPE and ORANGE. 

The following two sequences of directives produce the same results. 

(^REPLACE GRAPE -ORANGE /^IGNORE APPLE -CHERRY 

ANOREP FRUIT /* 



'FILE FRUIT 

I 

*FILE FRUIT 



COPY 

The directive format is: 

*COPY 

The COPY directive directs LIBEDIT to copy the new library file to the old library file after 
it has processed all correction statements. 



l-C-10 60435400 A 



LIBEDIT/LIBGEN EXAMPLES 

The following examples illustrate the use of LIBEDIT and LIBGEN. LIBEDIT manipulates 
program library files that can contain many different record types; LIBGEN only gener- 
ates a user library from relocatable (REL) records. 

Example 1: 



The following job builds a program library from a replacement file that consists of 
relocatable binary (REL) type records. 

LIBTES1. 
USER, EFD25. 
CHARGE, 16, 13N122. 
FTN, L=0. 
DEFINE, TESTLIB. 
CATALOG, LGO, R. 
LIBEDIT, P=0, N=TESTLIB. 
CATALOG, TESTLIB, R. 
/EOR 

SUBROUTINE A 

STOP 

END 

SUBROUTINE D 

STOP 

END 

SUBROUTINE C 

STOP 

END 

SUBROUTINE B 

STOP 

END 
/EOR 

*BUILD LIBRARY 
*B, *, REL/A,B,C,D 
/EOF 

The FORTRAN Extended compilation produces relocatable binaries on the default file 
LGO. 

The DEFINE statement creates a direct access permanent file TESTLIB on which the 
new program library will be written. 

The first CATALOG statement gives the following listing of the LGO file. 



c 


CATALOG 
NA*F 


OF LGO 
TYPE 


FTL C 
LENGTH 


1 
CK«:i|M 


n«Tf 


COMMFNTS 


76/nq/16. 0*.09.03. 


PAGE 


1 


1 

2 
3 

it 


A 

C 
B 


REL 
PEL 
R C L 
REL 


30 
30 
30 
30 


1220 
6030 
1613 
«5«.ll 


76/09/l«>. 
76/0 <»/!«>. 
▼t/pq/lf. 
76/0Q/16. 


06.08.C4 
C*.nft.5S 

P*.0«.5« 


NOS l.l r T N <».6if33 
NOS 1.1 FTM «..6<f33 
NOS 1.1 FTN U.6«»33 
NOS 1.1 FTM fc.6«»33 


666X T 
666X T 
666X I 
666 X T 


0PT=1 
OPT=i 
0PT=1 
OPT=l 



• EOP » SUM =• 
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The P=0 in the LIBEDIT statement indicates there is no old program library. The N 
parameter indicates the new program library will be written on file TESTLIB. The 
replacement file will be the default LGO. The directives will be on the default INPUT 
file. 

LIBEDIT reads the binaries from LGO and the directives from INPUT. On the basis 
of the directive specifications, the binaries are inserted before the end-of-file on file 
TESTLIB in the order specified in the directives (A, B, C, D). The directory record 
created is given the name LIBRARY as a result of the *BUILD directive. It is written 
before the end-of-file on the new program library TESTLIB. 

The directives are written to OUTPUT. The records on file TESTLIB are listed on 
the next page of OUTPUT. The following listing consists of these two pages. 



LIBEDIT DIRECTIVE CAROS. 



•HUH." LI"D8dy 
»B,»,REL/A,B,C,0 



76/o°/i*. 09.09.in. 



RECORDS WRITTEN ON FILE TESTLIB 
RECORD TVPf FTLE 



TNSEPTFO 


A 


RFL 


LGr 


INSERTED 


B 


R*L 


LGO 


INSERTED 


C 


RPL 


LGP 


INSERTS) 





REL 


LGC 


A MED 


LIBRARY 
»»E0F»* 


OfLD 


***** 



r»ATf 



rpv^cwT 



'6/09/1*. 08. OS.** 

76/09/16. n*.re.5* 

^/nq/t*. P8.n<».r« 

•'fc/oq/i*. o«.o«. c « 

■"6/09/16. 



76/no/l*. 08.09.n-». 



NOS 1.1 FT* 

"OS 1.1 FTK 

NOS 1.1 PTfc 

NO« 1.1 FTK 



b.6<»33 6*6X I 

«».6«»3"« 666* T 

U. 61.33 66*X I 

U.6«»3* 666X I 



opt=i 
opt=i 
npT=i 
nPT=i 



The second CATALOG statement produces the following listing of information about the 
records on TESTLIB. 



REC 



CATALOG 


QF TESTLIB 


PTLE 


1 






76/09/16. 08. 


09 


.0b. 


PAGF 


1 


na»F 


TYO(T 


LENGTH 


(XS'IM 


r ,rc 


T0VMFNTS 












A 


PEL 


30 


1220 


76/09/16. 


o«.n<«.«8 


NOS 1.1 F T N 




l«.6«»33 


66*X T 


0PT=1 


t» 


REL 


3P 


SUtl 


"'6/C?/16. 


r^.o'.Sfl 


NCS 1.1 FTN 




i».6«»3* 


66*X I 


OPT=l 


C 


REL 


3" 


1*1 ■« 


76/09/16. 


OR.0". B fl 


NOS 1.1 FT» 




*».fl»3* 


66*X I 


0PT=1 





REL 


30 


60*0 


T6/P9/16, 


n*.0».5B 


NOS 1.1 FTH 




U. 61*33 


666X t 


OPT=l 


LIBRARY 


OPL0 


1? 


?0 7 3 


?6/P°/16. 















Example 2: 

This job builds a new program library from an old program library by inserting new 
relocatable routines into and deleting routines from the old program library created in 
example 1 (TESTLIB). 
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LIBTES2. 

USER , EFD2S. 

CHARGE, 16, 13N122. 

FTN, L=0. 

ATTACH, OLD=TESTLIB. 

DEFINE, NEW=TES2LIB. 

LIBEDIT. 

CATALOG, NEW, R. 

/EOR 



/EOR 

♦TYPE REL 
*I, B, BONE 
*I,C,NEWC 
*D, C 
/EOF 



SUBROUTINE BOND 

STOP 

END 

SUBROUTINE D 

STOP 

END 

SUBROUTINE NEWC 

STOP 

END 



Three relocatable binaries (BONE, D, and NEWC) are produced via a FORTRAN 
extended compilation. 

The old program library (TESTLIB) is attached in read mode and is referenced as OLD. 

A direct access file (TES2LIB) is created for the new program library. This file will 
be referenced as NEW. 

LIBEDIT reads the binaries from the replacement file LGO and the input directives 
from file INPUT. It writes the modified old program library (OLD) to the new program 
library (NEW). BONE and NEWC are inserted after records B and C, respectively, and 
record C is deleted. Record D, which already existed on the old program library, is 
replaced by record D from the replacement file LGO. The following action is taken on 
file NEW. 



LIHF1TT r)TcefTT\ic rfoQ<z, 



7 */0<VlR. 01.09.""!. 



•TYPE REL 
























»I,B,QONE 
























•I.C.NEWC 
























♦0,C 
























RECORDS WPTTT 


EN ON 


PTLE NEW 






7*/na/l*. 


O^.O" 


■") 






page 


2 


RECORD 


TYPF 


FILE 


OATP 


rcpn^MT 
















4 


REL 


OL" 


76/09/16. 


n^.M.^i 


NO* 1.1 


FTN 


U 


HH 


RKAY 


T 


0PT=1 


Q 


REL 


OLD 


7*/0'Vl«,. 


r\*.Q*.*n 


NPS 1.1 


FTh 


u 


eur~* 


RARX 


I 


0PT=i 


IMSFRTEO BONE 


REL 


\.r.?. 


76/nq/i6. 


o«.n<i.?« 


NOS 1.1 


PTN 


u. 


At 3* 


666X 


I 


opt=i 


DELETED- (C> 


REL 


OLT 




















INSERTEO NEWC 


PEL 


Lf.O 


■'ft/O'J/l*. 


1W.0Q.JA 


no<; i.i 


FTN 


<♦, 


<U.-?t 


666V 


I 


npT=i 


REPLACED 


PEL 


LGC 


7*/nt»/i*. 


on.o°.?s. 


NOS 1.1 


FTN 


u 


6«.7'* 


616X 


T 


OPT = l 


AOOEO LIBRARY 


OPLO 


* ***• 


' 'f/nq/16. 


















»»r F»» 




0L n 





















60435400 C 



l-C-13 • 



The CATALOG shows the following content of the new program library. 



RFC 



CATALOG 


OF NEW 


FTLE 


1 






76/09/16. ON. 


09.31. 


PAGF 




1 


m*F 


TYPE 


LENGTH 


CKS'JM 


PATF 


TOMMFNTS 












A 


REL 


3" 


1220 


T 6/P9/16. 


08.0R.RB 


NOS 1.1 ptn 


«».6if33 


666V 


I 


OPT=l 


8 


REL 


3P 


5M1 


76/0°/16. 


pp.n«.«;e 


NOS 1.1 FTN 


<t.6<»33 


666X 


I 


0PT=1 


BONE 


REL 


3n 


06" 


76/09/16. 


0».P°,26 


NOS 1.1 PTN 


«».6<»33 


666X 


I 


OPT=l 


NEWC 


REL 


to 


13»7 


7*/09/16. 


0B.Pt. 26 


NCS 1.1 ctn 


'♦.P«»33 


666V 


I 


OPTsl 


D 


REL 


•»n 


6030 


76/09/16. 


0ft.PQ.26 


NOS 1.1 FTN 


"».6<»33 


666X 


T 


OPTsl 


LIBRARY 


OPLO 


1 r 


1312 


76/0<Vl6. 















• EOF 



Example 3: 

This job uses LIBGEN to generate a user library file from the program library file 
TES2LIB created in example 2. 

LIBTES3. 

USER, EFD25. 

CHARGE, 16, 13N122. 

ATTACH, TES2LIB. 

DEFINE, LIBLOAD. 

LIBGEN, F=TES2LIB, P=LIBLOAD, N=LOADLIB. 

CATALOG, LIBLOAD, R, U. 

/EOF 



The program library TES2LIB is attached to the job's control point, 
file LIBLOAD is defined for writing the user library file. 



A direct access 



LIBGEN scans TES2LIB and builds a ULIB directory of entry points, program names, 
and external references for relocatable (REL) records in the file. ULIB is copied to 
the file LIBLOAD, followed by the records from TES2LIB. A file index of random 
addresses for each record in the file is added as the last record of LIBLOAD. 
LOADLIB is the name of the ULIB and OPLD records. 

The CATALOG of the user library file LIBLOAD shows the following content. 



REC 



CATALOG 


OF LTB10A0 


FTL* 


1 






76/09/tft 


. 0«.10 


.01.. 


PARC 




1 


NAME 


TYPE 


LENGTH 


CKS'IM 


n«TF 


ro^Mt-MT*: 














LOADLTB 


ULIB 


13 


U2S7 


76/PQ/16. 
















A 


PEL 


30 


12-»0 


T 6/ n 9/16. 


P« .0".** 


NOS 1.1 


FTM 


t. 6i»33 


66*X 


I 


0PT=1 


8 


REL 


30 


•>tll 


76/09/16. 


08.0P.*B 


NOS 1.1 


FTM 


<».6«f33 


66*X 


I 


0PT=1 


BONE 


REL 


30 


0677 


76/PO/16. 


0B.O°.26 


NCS 1.1 


FTN 


*».6«.3^ 


666X 


I 


OPTsl 


NFWC 


REL 


■*o 


13" 


76/P«V16. 


PB.C.26 


VOS 1.1 


PTN 


t.6«»33 


66*X 


I 


0PT=1 





PEL 


3C 


60T0 


' T 6/0«>/ 1 «i. 


0*.P n .?6 


NOS 1.1 


CTH 


fc.6«»33 


666» 


I 


0PT=1 


LOADLIB 


OPLP 


1? 


6303 


76/pq/ie, 

















Example 4: 

This job deletes a record from the user library LIBLOAD created in example 3. It 
does this by deleting this record from the source library (the program library TEX2LIB) 
from which LIBLOAD was originally generated and generating a new version of LIBLOAD. 
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LIBTES4. 

USER, EFD25. 

CHARGE, 16, 13N122. 

ATTACH, TES2LIB. 

ATTACH, LIBLOAD/M=W. 

LIBEDIT, P=TES2LIB. 

LIBGEN, F=NEW, P=LIBLOAD, N=LOADLIB. 

CATALOG, LIBLOAD, R, U. 

/EOR 

*D, REL/A 

/EOR 

The program library TES2LIB (containing the relocatable routines used to generate the 
user library LIBLOAD) is attached to the job's control point. 

The user library LIBLOAD is attached in write mode. 

The LIBEDIT deletes the record A from TES2LIB. The modified new program library 
is written on file NEW (N parameter default). LIBEDIT produces the following listing. 



LTBEPIT DIRECTIVE CAPOS. 
•0, REL/A 



T 6/09/16. 0J.in.3d. 



RECORDS WRJtt 


EM ON 


FTL^ 


N^V 






7P/0O/1P. 


oi. n, 


.3", 






PAGF 


? 


RECORD 


TYop 




PTLP 


0* T E 


rov , H r NT 
















P<aFT-0-(A> 


REL 




TFS2LT" 




















B 


PEL 




Tr S?LT0| 


•''h/oo/i*. 


0*.01. *•> 


NOS 1.1 


CTN 


b, 


.^n 


666V 


T 


0PT=1 


BONE 


R^L 




TFS2LT9 


7 fc/09/i*. 


ob.p<). ?<s 


MPS 1.1 


FTK 


<♦, 


,^n 


666X 


T 


OPT=l 


Kirwc 


REL 




TcS2L Tr * 


■'f-fM/lb. 


"« .pi.?<i 


NOS 1.1 


FTH 


u. 


, 6^33 


*•£*■* 


T 


OPT=l 


D 


"EL 




Tr<;?l_Tq 


76/09/1*. 


0*. 09.26 


MPS 1.1 


F T N 


u, 


, (=>«»3"« 


*66Y 


T 


OPTrl 


ADDFn LIBRARY 


OPLD 




* »»»* 


76/P9/16. 


















»»E0F.»» 






tf<;?ltt 





















The LIBGEN statement generates a user library, using this new program library (written 
by LIBEDIT on the file NEW) as the source file. The user library is written on the 
file LIBLOAD and has the name LOADLIB. 

The CATALOG of the user library shows the following content. 



CATALOG O c LIBLOAD 
NAME TYPE 



LOADLIB 


ULTB 


R 


°EL 


BONE 


oct 


NEHC 


PFL 





ofl 


LOADLIB 


OPLO 



FTLE 


1 






LENGTH 


CK^'IM 


TATr 


rn"M e N' 


11 


l*T>2 


7A/09/16. 




■»o 


Stll 


76/pq/i*>. 


pe.o». c 8 


30 


0677 


7*/P*V16. 


08.0°. 26 


30 


13^7 


7*/pq/i6. 


08.00.26 


30 


6030 


76/p<?/i6. 


P*.0°.2K 


13 


U3*5 


'6/09/16. 





76/09/1*. P«.1P.31. 



» EOF » 



16«. 



NOS 1.1 
NOS 1.1 
NOS 1.1 
NCS 1.1 



FTM 
FTM 



fc.6«»33 
u.64 33 
«..6«»33 
i».6<»33 



66*X 
P66X 
66*X 
66*v 



1PT=1 
OPT=l 
0PT=1 
0PT=1 



Example 5: 

This job illustrates a technique of deleting records from a user library, which is an 
alternative to the method shown in example 4. This alternate method uses GTR to 
collect the relocatable records (REL) from the user library and makes the desired 
deletions from this file using LIBEDIT. Then, LIBGEN generates a user library, using 
this modified copy as the source. 
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LIBTES4. 

USER, EFD25. 

CHARGE, 16, 13N122. 

ATTACH, LIBLOAD/M=W. 

GTR, LIBLOAD, OLD. REL/* 

LIBEDIT. 

LIBGEN, F=NEW, P=LIBLOAD, N=LOADLIB. 

CATALOG, LIBLOAD, R, U. 

/EOR 

*D, REL/NEWC 

/EOF 

The user library generated in example 4 (LIBLOAD) is attached to the job's control 
point. 

The GTR statement reads the relocatable records from LIBLOAD and writes them on 
the file OLD. (This control statement terminates after OLD; the REL/* is a directive 
specifying all relocatable records.) 

LIBEDIT references the program library OLD and the directive record, deletes NEWC, 
and writes this modified file on the default NEW. The following is a listing of NEW. 



LIBEDIT DIRECTIVE CARDS. 
•0, REL /NEWC 



t*/o°/i*. n*.m.i»o. 



RECORDS WRITTEN ON FTLE N c « 



7*/0<Vlfi. 08.10.1.0. 



RECORD 


type 


ETLF 


DATF 


fOVH^NT 


















B 


PEL 


OLD 


7*/0<»/16. 


OO.O*.^ 


NDS 


1.1 


ptk 


b, 


,6''3'» 


66*X 


T 


0PT = 1 


BONE 


REL 


OLD 


•'f/ni/lfi. 


0*. 09.26 


mos 


1.1 


FT N 


u. 


, 6<»T< 


P66Y 


T 


PPT = 1 


CFLETEO-(NEWC) 


REL 


OLn 






















P 


REL 


OLD 


'6/rn/lfi. 


•>».P9.?6 


Npc 


1.1 


FTN 


u, 


.M-3 - * 


66»>y 


I 


0P T =1 


»»CQF»» 




OLD 























LIBGEN generates a new user library on the file LIBLOAD. It uses NEW as the source 
and names the new user library LIBLOAD. 

The user library is cataloged to show the following contents. 





CATALOG 


OF LIBLOAD 


PTLP 


1 






7 «s/09/16. !1B. 


10.l»l. 


PAT.P 




1 




c 


NAME 


TYPE 


LENGTH 


CKS'J* 


PA-rr 


rOMM^NTS 














1 


L0A0LTB 


ULTP 


7 


37*7 


^6/09/16. 
















•> 


B 


REL 


30 


"til 


"'fi/PO/iR. 


r».np.5»« 


NO* 1.1 F'M 


«».f433 


6fi*X 


I 




OPT=l 


3 


BONE 


REL 


3P 


Qfi-'T 


^/oq/i6. 


0ft.P°.?* 


NCS 1.1 "N 


U.F,a33 


66ftv 


T 




OPT = l 


t* 





REL 


30 


6030 


T 6/P°/1f . 


p".p°.?p 


NOS 1.1 "H 


V.6U33 


66** 


I 




"PT=1 


«; 


LOAOLIB 


OPLD 


11 


71! "'7 


■^/pq/16. 

















• EOF » 



Example 6: 

This job uses LIBEDIT to add a user library to a program library. The user library is 
the version of LIBLOAD generated in example 4. The program library is an existing 
file, MYLIB. Since LIBEDIT manipulates ULIB type programs as a single unit, the 
entire user library is added to the program library. LIBEDIT cannot access individual 
elements within a user library. 
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LIBTES6. 

USER, EFD2 5. 

CHARGE, 16, 13N122. 

ATTACH, MYLIB. 

ATTACH, LIBLOAD. 

DEFINE(NEW=NEWLIB) 

LIBEDIT, P=MYLIB, B=LIBLOAD. 

CATALOG, NEW, R. 

CATALOG, NEW, R, U. 

/EOR 

*ADD, LIB2, ULIB/LOADLIB 

/EOF 

MYLIB and LIBLOAD are attached to the job's control point. 

A direct access file NEWLIB is defined. It is referenced as NEW so it can serve as 
the default file on which the new program library will be written. 

LIBEDIT reads the replacement file LIBLOAD and the input directive. The directive 
specifies that the addition will be before the zero- length record that terminates the 
second library on the old program library. The addition will be the user library 
LOADLIB. The new program library is written on NEW with an updated file directory 
added at the end. The following listing of NEW is written to OUTPUT. 



Ll^ni 1- mppp-Tvr raons. 

»ft0n,LTB2.ULIB/lO«DLTB 



7*/09/16. 08.in.SQ. 



RECORDS WRITTEN ON FILE NEW 



▼P/09/1*. 08.10. C Q. 





RECORD 


TVDC 


FTLF 


n«Te 


roMMP^T 




OUT 
00 


pp 


MYLTB 
MYLIB 


■>K/n»/f)«. 


■"=/n*/?n. 


INSERTED 


m«;opt 

LOADLIB 

00 


OVL 
IILIB 


MYLIB 

LTBL040 

MYLIB 


■'ft/OS/O*. 
'6/0O/16. 


'1/03/01. 




PROCl 

PR0C21 

00 


TFVT 
TEXT 


MYLTB 
MYLIB 
MYLIB 






anoFD 


COMCXIO 

OUT 

MSORT 
MYLIB 
»»E0F»» 


OPLC 
OPL 
OPL 
OPLO 


"YLIB 
MYLTB 

MYLIB 

• »»#» 

MYLTB 


''ft/OO/lfc. 
'6/0P/1«». 
76/OP/l^. 
7*/09/l*. 





PFLE*SF output FTL r<: . 
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The first CATALOG shows the following content of the new program library. 



REC 


CATALOG 
NAME 


or MEW 
TYPE 


PTLP 
LENGTH 


1 
ri<su»» 


nATF 


I 

* 


OUT 
(0Q> 


PP (1100) 
SUM = 


25*- 
25c 


6220 


76/PA/O*. 


1 
3 


MSORT 

LOAOLIB 

(00> 


OVL 00«00 
ULTB 

SUM = 


26? 

7 


o-»?o 

•?7-»7 


76/PVO*. 
"»R/09/l*. 


10 
11 
1? 


PR0C1 

PROC21 

(00) 


TEXT 
TEXT 

SUM = 


u 


701" 
165? 




IV 
15 
16 


COMCXIO 
OUT 
MSORT 
MY LIB 


OPLC C6fc) 
OPL (6M 
OPL (6fc) 
OPLO 


«?13 

161«; 

?0U2 
?3 


0003 
l«»tl 


7«/09/lU. 

•»f/nq/iu. 

7ft/0<>/16. 


1' 


» eof • 


SUM = 


«T«5fc 







comments 



76/09/16. 0*.11.00. PAGF 
"PLEASE OUTPUT FTLES. 



The entire user library is added to the program library. 

The second CATALOG specifies the U parameter, which includes the records of the 
user library in the following listing. These records begin a second page in the 
printout. 

1 





RAT8L0G 


OF MEH 




FTL* 


PFC 


NAME 


TTPF 


L' 


CNGTH 


t 


OUT 


PP (1100) 




25* 


? 


CO 1 )) 


•tl" = 




9RC 


1 


MSORT 


OVL 00,00 




262 



76/09/1*. 0«.11.01. PAG C 1 
ocjrucr OUTPUT FTLES. 
0720 76/0"/0*. •'l/OJ/Ol. 73/09/15. "ULTt-tfomnAL SOPT ROUTINE. 



PK«:iJ«* PATF rOMMFNTS 
6?20 76/rVC*. "' B /0*/20. 





CATALOG 


OP NEW 




e TLE 


1 




•EC 


NAIF 


ryor 




LENGTH 


CKSUM 


flftTF rOHMF»|l 


<• 


LOAOLIB 


•ILTB 




T 


37'7 


T«/pe/16. 


t; 


R 


REL 




TO 


5I»11 


7*/r9/i5. o».o«.«!e 


6 


BONE 


REL 




30 


«sr 


76/P9/16. 08.0". 26 


"* 





REt 




TO 


6010 


76/09/16. 0*.0«.?6 


< 


LOAOLIB 


OPLO 




11 


7n-»7 


76/00/16. 


n 


(10) 


SUM = 


M2 






m 


PROC1 


TFVT 




i» 


7pi«; 




n 


PR0C21 


TEXT 




kU 


16*;? 




12 


CO 01 


*U« ■= 


"P 






13 


COMCXTO 


OPLC 


(6b) 


513 


0003 


76/0O/tfc. 


iU 


PUT 


OPL 


(6«») 


1615 


1*11 


76/09/lfc. 


l«s 


MS CRT 


OPL 


(6fc) 


20«»2 


3*71, 


Tf/no/Jfc. 


16 


MYLTB 


OPLO 




?3 


kU7k 


'6/09/16. 



'6/09/16. OH. 11. 01. 



NOS 1.1 
N0S 1.1 
NCS 1.1 



FTH 
FTM 
FTN 



fc.6fc3t f6»x i 

*.6«»33 666X T 
I».6fc33 66*X T 



OPT=l 
OPTsl 
0PT=1 



• EOF • 
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JOB OUTPUT INFORMATION 



Appendix D lists the output information printed for the sample job shown below. The 
notes in the right margin identify the various format conventions of NOS output. The 
job consists of the following statements. 

TESTA(CM50000, T10) 
USER(JEANCOM, PASSWOR, SYS172) 
FTN. 
-EOR- 

PROGRAM CONVER(INPUT, OUTPUT) 
C THIS PROGRAM CONVERTS OCTAL TO DECIMAL 

C THE SECOND VALUE PRINTED IS 10 OCTAL TIMES THE FIRST 

C TERMINATE BY TYPING ZERO 

2 CONTINUE 

READ 1,J 
1 FORMAT (08) 

K=J*10B 

PRINT 6, J,K 
6 FORMAT(5X,I10, 5X.I10) 

IF(J.EQ. 0)3,2 

3 CONTINUE 

STOP 
END 
-EOI- 



60435400 A 1-D-l 



d 
i 

to 



o 

CO 
Ol 

►£» 
o 
o 

W 



MOS 1 yy/mm/dd. 

OPrRATINS SYSTEM 
JOB ORIGIN = BATCH. 

USER DUMBER = JEANCOM 
JOBCARD NAME = TESTAOO 



AAAAAAAAAA 


AAAAAAAAAA 


FFFFFFFFFFFF 


IIIIIIIIIIII 


AAAAAAAAAAAA 


AAAAAAAAAAAA 


FFFFFFFFFFFF 


IIIIIIIIIIII 


AA AA 


AA 


AA 


FF 


II 


AA AA 


AA 


AA 


FF 


II 


AA AA 


AA 


AA 


FF 


II 


AA AA 


AA 


AA 


FF 


II 


AA AA 


AA 


AA 


FF 


II 


AA AA 


AA 


AA 


^FFFFFFF 


II 


AAAAAAAAAAAA 


AAAAAAAAAAAA 


FFFFFFFF 


II 


AAAAAAAAAAAA 


AAAAAAAAAAAA 


FF 


II 


AA AA 


AA 


AA 


FF 


II 


AA AA 


AA 


AA 


FF 


II 


AA AA 


AA 


AA 


FF 


II 


AA AA 


AA 


AA 


FF 


II 


AA AA 


AA 


AA 


FF 


IIIIIIIIIIII 


AA AA 


AA 


AA 


FF 


IIIIIIIIIIII 



The first three lines of the banner page indicate that this local batch job 
was run under the control of the Network Operating System. The system 
creation date is specified by yy/mm/dd. (year/month/day.). 

The user number is that which was supplied on the USER statement. The 
jobcard name is the name of the particular job which was supplied on the 
job statement. 



AAAAAAAAAA 
AAAAAAAAAAAA 
AA AA 

AA AA 

AA AA 

AA AA 

AA AA 

AA AA 

AAAAAAAAAAAA 
AAAAAAAAAAAA 
AA AA 

AA AA 

AA AA 

AA AA 

AA AA 

AA AA 



JJJJJJJJJJJJ 
JJJJJJJJJJJJ 

JJ 

JJ 

JJ 

JJ 

JJ 

JJ 

JJ 

JJ 

JJ 

JJ 

JJ 
JJ JJ 
JJJJJJJ 
JJJJJ 



cccccccccc 
cccccccccccc 



cc 
cc 
cc 
cc 
cc 
cc 
cc 
cc 
cc 
cc 
cc 
cc 



cc 



cc 



cccccccccccc 

cccccccccc 



The first four characters 
of the banner job name 
are generated from the 
user index associated 
with the user number. 
These four characters 
are unique to each user 
and remain the same for 
subsequent jobs run under 
the same user number. 
The last three characters 
are the job sequence num- 
ber assigned by the sys- 
tem at the time of pro- 
cessing. 



yy/mm/dd. hh. mm. ss. 



This line specifies the current date (year/month/day. ) 
and the time (hours, minutes, seconds. ) when job 
printing was initiated. 



o 

4^ 
CO 

en 
£> 
o 
o 

W 



PROGRAM' CONVER 



73/7^ 0PT=1 



FTN t».t»+U(+0i 



yy/mm/dd. hh. mm. ss. 



PAGE 



10 



PROGRAM CON VERdSPUT, OUTPUT) 
C THIS PROGRAM CONVERTS OCTAL TO OE^IMAL 

C THE SECOND VALUE PRINTED 13 10 OCTAL TIMES THE FIRST 

C TERMINATE 3Y TYPING ZERO 

2 CONTINUE 
READ 1,J 

1 FORM AT (08) 

K=J*103 

PRINT 6,J,K 
6 FORMAT(5X,I10,5X,I10) 

IF(J.EO.0)3,2 

3 CONTINUE 
STOP 

END 



The job calls the FORTRAN Extended compiler 
which compiles the program, CONVER, contained 
in the program record. The symbolic reference 
map for program CONVER is printed below. 



SYMBOLIC REFERENCE MAP (R=l) 



ENTRY POINTS 
^107 CONVER 



VARIABLES 


S* 


TYPE 


RELOCATION 








'-137 J 




INTEGER 




*»1*»0 


K 


INTEGER 


FILE NAMES 




MODE 










INPUT 




FMT 


2QM OUTPUT 


FMT 







STATEMENT LABELS 
hlZt* 1 FMT 

-133 6 FMT 



M10 2 



3 



INACTIVE 



STATISTICS 

PROGRAM LENGTH 
BUFFER LENGTH 



36B 
M0 3B 



30 
2115 



i 

d 



I 



Oi 

o 

£>■ 
CO 
en 
£>. 

o 
o 

O 



AAFIAJC. yy/mm/dd. (10) CYBER 172. 

0B.0B.5"'.LI8TES1. 

OP. 08 ,5 7 .USER,MMA0DEN, . 

8.03.58.CHARGE,10 9T,90MF. 

08.08.c«i.FTN,L=0. 

08.09.0?. .095 CP SECONDS COMPILATION TIME 

8.no.0'.OEPINE,TESTLTB. 

8. 09. 3. CATALOG, LG0,R. 

08.09.03. CATALOG COMPLETE. 

08.09.0 3.LI8EOTT,P=0,NrTESTLTB. 

08.09.0U. EOITING COMPLETE. 

8. C9.0U. CATALOG, TESTI. IB, R. 

08.09.0U. CATALOG COMPLETE. 

08.0«>.P<*.UEAD, 0.002KUNS. 

08.09.0U.UEPF, 0.013KUNS. 

08.09.0U.UEMS, 2.360KUNS. 

08.0°.0U.UECP, 0.157SECS. 

08.09.0U.AESR, 2.0D3UNTS. 

08.15.15.UCLP, 23, 0.512 *LNS. 



NOS 



This line specifies the job name, the current date, 

and the computer system being used. 

The dayfile includes a listing of the control state- 
ments, system- supplied status messages, and 
program output, if any. Spaces precede status 
messages and program output. Each line includes 
the time the message was issued to the dayfile. 

The last six lines specify the type and amount of 

system resources the job used. 

This job used 0. 002 kilounit of application 

activity, 0.013 kilounit of permanent file activity, 

2. 360 kilounits of mass storage activity, 0. 157 seconds 

of central processor time, and 2.003 SRU. The job 

produced 0. 512 kiloline (512) of printable output. 

Depending on the resources used, additional information 

may be included in the dayfile. Refer to Job Completion, 

section 3 for the formats of these messages. 



PERMANENT FILE DEVICE STATISTICS 



The system allocates space for permanent mass storage files in units called reservation 
blocks. The size of a reservation block depends upon the type of file and/or the type 
of device on which the file is to reside. For indirect access files, the reservation 
block size is always one PRU (64 CM words), regardless of the device residence. 
For direct access files, the reservation block size is a multiple of PRUs and varies 
according to the device type, as shown in the following table. 



Device 
Type 


Device 


PRUs / 
Block 


CM 
Words Characters 


Maximum 
No. of Blocks 


DE 


Extended Core Storage 


16 


1024 10,240 


121 for 125K 
243 for 250K 


DI 


844-21 Disk Storage 
Subsystem (l<n< 8) 


n*107 


n*6, 848 n*68, 480 


1616 


DJ 


844-41/44 Disk Storage n*227 
Subsystem (l<n< 8) 


n*14, 528 n*145, 280 


1640 


DP 


Distributive Data 
Path to ECS 


16 


1024 10,240 


121 for 125K 
243 for 250K 



MD 



841 -n Multiple Disk 
Drive (l<n<8) 



n*32 



n*2048 n*20, 480 



1600 



In this table, n indicates the unit count for multiunit devices. 

In general, the largest permanent file the user can create is a direct access file that 
resides on a nonmaster device within his family of permanent file devices. Such files 
are restricted in size by the limitations of the device itself and the DS validation 
parameter which limits the size of direct access files. If no DS restriction is imposed, 
the maximum file size equals the maximum number of reservation blocks that can be 
allocated for the device. 

All other permanent files reside either on the user's master device or on an auxiliary 
device. Their maximum size is restricted to the device limit minus any space allo- 
cated for catalog information and other files. In addition, an installation can use the 
FS validation parameter to limit the size of indirect access files. 



60435400 C 



1-E-l 



CARD FORMAT AND CONVERSION PROBLEMS 
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Data within the system is stored in binary or coded records. Binary records are vari- 
able in length and consist of central memory images. Coded records consist of lines 
of display-coded characters. Binary and coded data can enter the system in several 
different formats. Some of these formats can enter the system directly; others must be 
converted into a system-recognizable format. In either case, there are several formats 
in which the data can reside in the system. Accordingly, the processing program must 
take into account the specific format of data it accesses. 

This appendix describes the formats for punched cards and the format for printed data. 
It also describes the conversion performed by the system on data transferred between 
the system and peripheral devices and the method by which time- sharing terminal data 
is converted in the system. 

When using the 64-character . set, the user should avoid using consecutive colons (00 
characters). It is possible for these colons to be interpreted as an end-of-line. An 
end-of-line is defined as 12 to 66 bits of zero, right-justified in one or two central 
memory words. If consecutive colons appear in the lower 12 bits of a central memory 
word, they are interpreted as an end-of-line rather than as colons. 

Example: 



The following characters are punched on a coded card beginning in column 1. 
:::::::::A::::::::AA 

This would appear in memory as follows: 



59 




47 




35 




23 




11 







00 


00 




00 


00 




00 


00 




00 


00 




00 


01 




: 


• 


: 


: 


•* 


: 


: 


: 


'• 


A 




00 


00 




00 


00 




00 


00 




00 


00 




01 


01 




: 


: 


: 


: 


: 


: 


: 


: 


A. 


A 




00 


00 




00 


00 




00 


00 




00 


00 




00 


00 





end-of-line 
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However, if the characters were copied with the COPYSBF utility, the following would 
appear. 



59 


47 35 23 


11 





55 00 


00 00 


00 00 


00 00 


00 00 


end-of-line 


01 00 


00 00 


00 00 


00 00 


00 01 


A : 


: • 


: : : : 


: A 




01 00 


00 00 


00 00 


00 00 


00 00 



A 



end-of-line 



NOTE 



If a colon is the last character of a line, the 
system appends a blank character to preserve 
the colon and then appends an end-of-line 
( two blanks may be added to ensure an even 
number of characters). 



FORMATS FOR CARDS READ 

The system reads cards in coded and binary formats, 
in both formats. 



The following conditions apply 



• A card with a 7/8/9 punched in column 1 is an EOR mark. 

• A card with a 6/7/9 punched in column 1 is an EOF mark. 

• A card with a 6/7/8/9 punched in column 1 is an EOI mark. 

The remainder of each card is ignored except for columns 79 and 80 of the EOR and 
EOF cards. These columns can contain the keypunch conversion mode for the input 
records that follow. Conversion modes are discussed in the following section. 

CODED CARDS 

Cards are read in Hollerith punch code. The 3447 card reader controller converts the 
Hollerith code to internal BCD code and passes the data to the card reader driver. The 
driver converts the data from internal BCD code to display code. Up to 80 characters 
can be transferred per card. Trailing spaces are deleted. 

Two conversion modes, 026 and 029f , exist for the Hollerith punch code. All data 
is converted in the system default keypunch mode unless a conversion mode change is 
specified. This change can be specified on any of the following cards. 

The job card, 7/8/9 card (EOR mark), and 6/7/9 (EOF mark) can contain the keypunch 
conversion mode in columns 79 and 80. A 26 punched in columns 79 and 80 indicates 
all subsequent coded cards are converted in 026 mode. A 29 indicates subsequent 

t These codes are ignored by a 200 User Terminal since conversion mode is selected 
by a hardware switch. (Refer to the Export/import Reference Manual. ) 
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cards are converted to 029 mode. Each conversion change remains in effect until an- 
other change card is encountered or the job ends. The user can switch between 026 
and 029 mode as often as desired. If 26 or 29 does not appear in columns 79 and 80 
of the job card, the initial keypunch mode of that job is the system default mode. 
If 26 or 29 does not appear on a 7/8/9 or 6/7/9 card, no conversion change is made 
and the most recent keypunch mode remains in effect. 

Keypunch mode can also be changed by a card containing a 5/7/9 punch in column 1. 
A blank (no punch) in column 2 indicates 026 conversion mode; a 9 punched in column 
2 indicates 029 mode. The conversion change remains in effect until another change 
card is encountered or the job ends. 

The 5/7/9 card also allows literal input when 4/5/6/7/8/9 is punched in column 2. 
Literal input allows 80 column binary data to be read while transmitting input in coded 
mode. Cards are read (16 central memory words per card) until a card identical to 
the previous 5/7/9 card (4/5/6/7/8/9 in column 2) is read. The next card can then 
specify the new conversion mode. 

BINARY CARDS 

Binary cards are denoted by a 7/9 punch in column 1 and can contain up to 15 central 
memory words. The 3447 card reader controller reads the binary data and passes it 
to the card reader driver in 12-bit codes. Each card column row corresponds to a bit 
position. The driver checks the checksum figure if this option is specified. The driver 
then passes the data to the central memory buffer. 

The fields within a binary card are: 

Column(s) Description 

1 7/9 punch indicates a binary card 

4 punch ignores checksum punch in column 2 

Rows 0, 1, 2, and 3 contain the binary equivalent of the 
word count of the card 

2 Binary data checksum (modulo 4095) 

3 through 77 15 central memory words of binary data 

78 Blank 

79 and 80 24-bit binary card sequence number 
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SUMMARY 

The following punches appearing in column 1 of a card, have the corresponding meaning 
to the card reader driver. 

Punch Represents 

7/8/9 End-of-record (optional conversion mode change) 

6/7/9 End-of-file (optional conversion mode change) 

6/7/8/9 End-of-information 

5/7/9 Conversion mode change /read 80 -column binary 

7/9 Binary card 

Not 7 and 9 Coded card 

FORMATS FOR CARDS PUNCHED 

Punched cards can be in three formats. 

• Coded (punch Hollerith) 

• Binary 

• Absolute binary 

The following conditions apply to all three formats. 

• When an EOR is encountered, a card is punched with a 7/8/9 in columns 1 and 
80. -This card is offset. 

• When an EOF is encountered for a file, a card is punched with a 6/7/9 in 
columns 1 and 80; the remainder of the card is blank. This card is offset. 

e When an EOI is encountered on a file, a card is punched with a 6/7/8/9 in 
columns 1 and 80; the remainder of the card is blank. This card is offset. 

• If a compare error is encountered, the erroneous card and the following card 
are offset. These two cards are repunched until no error is detected. An 
EOI card with 6/7/8/9 punches in columns 1 and 80 contains a binary count in 
column 40 of the number of compare errors. 

e During the punching of each file, the system maintains a count of the number 
of cards punched for the file. If the number exceeds the limit for which the 
user is validated, punching of the file is terminated. A special banner card 
with the word LIMIT is punched and offset as the last card of the deck. 

The following methods are used by the system to punch each of the three forms of 
cards. 

CODED CARDS (PUNCH) 

With the exception of decks punched via the DISPOSE request, the keypunch mode 
(026 or 029) of coded cards depends on the job origin type. If the job is of local 
batch origin, decks are punched in the initial keypunch mode (that is, the mode speci- 
fied on the job card or set by system default). For all other job origin types, decks 
are punched in the system default keypunch mode. However, the DISPOSE request 
allows, the user to specify that decks be punched in either 026 or 029 mode, regard- 
less of the job's keypunch mode. 
l-F-4 60435400 A 



BINARY CARDS (PUNCHB) 

The card punch driver retrieves 15 words of binary data from central memory. The 
driver then generates a checksum for the data and issues a card number. The card 
punch controller receives the binary data and punches it on the card unchanged, that is, 
in 12 -bit codes. Each row in a card column corresponds to a bit position. The driver 
formats the binary card in the following manner. 

Column(s) Contents 



1 7/9 punch denotes binary card 

Rows 0, 1, 2, and 3 contain the binary equivalent of the 
word count of the card 

2 Binary data checksum (modulo 4095) 

3 through 77 15 central memory words of binary data 

78 Blank 

79 and 80 24-bit binary card sequence number 

ABSOLUTE BINARY CARDS (P8) 

Absolute binary cards are central memory images in 12 -bit codes. Each row in a card 
column corresponds to a bit position. Sixteen central memory words are punched per 
card with no special punches or fields added. 

PRINTED DATA 

All printed data is in coded format. The line printer driver extracts data until an end- 
of-line mark, occurs or until 14 central memory words are retrieved. The end-of-line 
is denoted by a zero byte as the last byte of a central memory word. The print line 
consists of a maximum of 136 characters. If an end-of-line mark does not appear after 
136 characters, the last four characters of that group are lost. The driver converts the 
extracted data from display code to internal BCD code (refer to appendix A for the 
character set equivalences) and forwards the data to the line printer controller. 

The driver interprets the first character in a line as the carriage control character 
(refer to appendix A) and that character is not printed. In most cases, the proper 
carriage control is issued while the remainder of the line is printed. However, when 
Q, R, S, or T is specified, no printing takes place for that line. The Q, R, S, and 
T format controls remain in effect until changed, and all other carriage control options 
must be supplied for each line they control. Line spacing is normally done in the auto 
eject mode; that is, creases in the paper are skipped by the line printer controller's 
automatic line spacing mechanism if the paper is loaded properly. Auto eject mode I 

must be deselected if the user wants to employ format channels to advance printing I 

from a position above the bottom of form to a position beyond the next top of form. | 

During the printing of each file, the system maintains a count of the number of lines printed/ 
skipped for the file. If the number exceeds the limit for which the user is validated, printing 
of the file is terminated. The informative diagnostic LINE LIMIT EXCEEDED is printed. 
If a job's dayfile is part of the terminated print file, the dayfile is subsequently printed. 

The installation can impose an implied page control by setting a certain number of default 
lines for each page. If less than the default number of lines is printed/ skipped on a page, 
the line limit is still decremented by the default number of lines. 
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TERMINAL CHARACTER CONVERSION 

Normal input mode from a terminal consists of a 64-character set where all lowercase 
alphabetics are converted to uppercase characters. Under ASCII mode, the characters 74 
and 76 represent the beginning of a 74xx or 76xx escape sequence. Under normal mode, 
the characters 74 and 76 are treated as data rather than escape codes. ASCII and normal 
modes apply to both input and output. 

DATA INPUT 

The terminals which NOS supports can be grouped into ASCII terminals and correspondence 
code terminals. The manner in which the characters entered from a terminal are in- 
terpreted by the system depends on whether the user specifies that the characters belong 
to the full character set. For example, if the user enters the following characters to be 
mapped into the full ASCII set 

aAbBcCdDeEfF 

the central memory equivalent is:t 



59 


47 


35 


23 


11 


7.a oi 


01 76 


02 02 


76 03 


03 76 


04 04 


76 05 


05 76 


06 06 


00 00 



However, if a NORMAL command is issued, the characters are mapped into the subset of 
the ASCII character set; then the central memory equivalent is: 



59 


47 


35 


23 


1L 


01 01 


02 02 


03 03 


04 04 


05 05 


06 06 


00 00 


00 00 


00 00 


00 00 



In ASCII mode, 1 1 a H 128 characters from an ASCII or correspondence code terminal are 
recognized. These characters, in addition to the first 64, are processed as 12-bit char- 
acters with an escape code convention as shown previously. Table 1-A-l lists the character 
set equivalences. The programs that process data must recognize that data is in ASCII 
mode rather than normal display code and process it accordingly. 

DATA OUTPUT 

Data output is in either a 64/63- or 128 -character set, depending on whether the terminal is 
in normal or ASCII mode. When the terminal is in normal mode, the codes 74 and 76 
represent data rather than escape codes. In ASCII mode, 74 and 76 are treated as the 
beginning of an escape sequence. All information is transmitted in even parity unless the 
user specifies odd parity. 

For a more detailed description of terminal operation, refer to the Time -Sharing User's 
Reference Manual. 

Data can also be transmitted to or from a terminal through a paper tape reader. The paper 
tape character mode is always ASCII. 



t Partial words are zero-filled; partial bytes are blank-filled. 
1 1 Refer to the Time-Sharing User's Reference Manual for descriptions of the ASCII and 
NORMAL commands. 
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TAPE LABELS 



The operating system accepts ANSI standard and nonstandard labeled tapes. Labels 
which do not conform to ANSI standards in format and/or content are defined as non- 
standard. 

ANSI labels perform two functions. They provide information that uniquely identifies 
a file and the reel on which it resides, and they mark the beginning and end of a file 
and the beginning and end of a reel. 

ANSI labels are designed to conform to the American National Standard Magnetic Tape 
Labels for Information Interchange X3. 27-1969. All labels are 80 characters in length 
and are recorded at the same density as the data on the tape. The first three char- 
acters of an ANSI label identify the label type. The fourth character indicates a number 
within a label type. 

The following is a summary of each label type, name, function, and whether or not it 
is required. 



Type No. Name 

Volume header label 
User volume label 
File header label 
File header label 
User header label 
End- of- file label 
End- of- file label 
User trailer label 
End- of- volume label 

EOV 2-9 End- of- volume label 



VOL 


1 


UVL 


1-9 


HDR 


1 


HDR 


2-9 


UHL 


t 


EOF 


1 


EOF 


2-9 


UTL 


t 


EOV 


1 



Used At 

Beginning-of -volume 

Beginning-of-volume 

Beginning-of- file 

Beginning-of-file 

Beginning-of-file 

End-of-file 

End-of-file 

End-of-file 

End-of-volume 

End-of-volume 



Required /Optional 

Required 

Optional , 

Required 

Optional 

Optional 

Required 

Optional 

Optional 

Required when 

appropriate 

Optional 



REQUIRED LABELS 

The VOL1, HDR1, and EOF1 labels are required on all ANSI- labeled tapes. In addition, 
an EOV1 label is required if the physical end- of- tape reflector is encountered before an 
EOF1 label is written or if a multifile set is continued on another volume. In the 
descriptions of the contents of these labels, n is any numeric digit and a is any letter, 
digit, or any of the following special characters. 



| Any member of the CDC 6-bit subset of the ASCII character set. 
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A 


) 


< 


J 


♦ 


= 


it 


+ 


> 


t 


» 


? 


$ 


- 


@ 


% 
& 


i 


[ 

\ 


/ 
( 


> 


] 
A 



Some fields are optional. An optional field which does not contain the designated infor- 
mation must contain blanks. Fields which are not described as optional are required 
and will be written as specified. Note that n-type fields are right- justified and zero- 
filled, and a -type fields are left- justified and blank- filled. 

VOL1 — VOLUME HEADER LABEL 

The volume header label must be the first label on a labeled tape. All reels begin with 
a VOL1 label. If two or more reels belong to a volume set, the file section field in 
the following HDR1 label gives the actual reel number. 



VOL 


1 


volume serial number 


va 


reserved 


reserved 


reserved 


owner 
identification 


owner identification (oid) 


oid 


reserved 


reserved 


reserved 


lsl 
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Character 
Position 

1-3 


Field Name 

Label 
identifier 


Length 
(in characters) 

3 


Contents 
Must be VOL 


Default 


Checked on 
Read 


CO 
►&. 

o 
o 


Yes 


> 


4 


Label number 


1 


Must be 1 




Yes 




5-10 


Volume serial 
number 


6 


Volume identification 
assigned by owner to 
identify this physical reel 
of tape 

An a character which in- 


As read from 
existing label 


Yes, if the 
file was 
assigned by 
volume serial 
number 




11 


Accessibility 
(va) 


1 


dicates the restrictions, 
if any, on who may have 
access to the information 


Blank (un- 
limited access) 


No (refer to 
BLANK control 
statement) 



12-31 Reserved for 

future standardi- 
zation 



20 



on the tape. A blank 
means unlimited access. 
Any other character 
means special handling, 
in the manner agreed 
between the interchange 
parties. Refer to the 
BLANK control statement. 

Must be blanks 



No 



32-37 Reserved for 

future standardi- 
zation 



Must be blanks 



No 



38-51 



52-79 



Owner identi- 
fication (oid) 



Reserved for 
future standardi- 
zation 



14 



28 



Any a characters identify- family 

ing the owner of the name, user 

physical volume number 

Must be blanks 



Refer to dis- 
cussion of fa 
field of HDRl. 

No 



80 



i 

O 



Label standard 
level (lsl) 



1 means the labels and data 
formats on this volume con- 
form to the requirements of 
the ANSI standard. A blank 
means the labels and data 
formats on this volume 
require the agreement of the 
interchange parties. 



No 



HDR1 — FIRST FILE HEADER LABEL 

The first file header label must appear before each file. When a file is continued on 
more than one volume, the file header label is repeated after the volume header label 
on each new volume for that file. If two or more files are grouped in a multifile set, 
each HDR1 label indicates the relative position of its associated file within the set. 



HDR 


1 


file identifier (fi) 


file identifier (fi) 


fi 


set identification 


file section v 
number vsecno) 


secno 


file 
sequence number 


generation number 


gvn 


gvn 


creation date 


expiration 
dat.p 


expiration 
date 


fa 


block count 


system code 


system code 


reserved 
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o 

CO 

o 
o 



Character 
Position 


Field Name 


(in 


Length 
characters) 


Contents 


1-3 


Label 
identifier 




3 


Must be HDR 


4 


Label number 




1 


Must be 1 


5-21 


File identifier 
(fi) 




17 


File identification 
parameter on the ] 



Default 



Blank 



Checked on 
Read 



Yes 

Yes 

Checked if 
specified 



22-27 



Set identification 



Set identification as speci- 
fied by the setid parameter 
on the LABEL control 
statement. This value 
must be the same for all 
files of a multifile set. 



Blank 



Checked if 
specified 



28-31 File section 

number (secno) 



32-35 File sequence 

number 



The file section number of 0001 
the first HDR1 label of a 
file is 0001. If the file 
extends to more than one 
volume, this number is 
incremented by one for 
each subsequent volume. 
This value corresponds to 
the secno parameter on the 
LABEL statement. 

Position of a file within a 0001 
file set, as specified by the 
seqno parameter of the 
LABEL statement. This 
value is 0001 for the first 
file, 0002 for the second, 
and so on. In all the labels 
for a given file, this field 
will contain the same number. 



Checked if 
specified 



Checked if 
specified 



i 

a 
i 

cn 



I 

o 

I 



Character 
Position 

36-39 



Field Name 

Generation 

number 

(optional) 



Length 
(in characters) 



Contents 

Generation number of a file, 
as specified by the genno 
parameter of the LABEL 
statement. This value is 
0001 for the first generation 
of a file, 0002 for the second, 
and so on. 



Default 



0001 



Checked on 
Read 

Checked if 
specified 



40-41 



Generation 
version 
number (gvn) 



42-47 



Creation date 



Two n characters used to 00 

distinguish successive 
iterations of the same 
generation. The generation 
version number of the first 
attempt to create a file is 
00. This value corresponds 
to the gvn parameter of the 
LABEL control statement. 

Date the file was created; Current date 

it is recorded as a space 
followed by two n char- 
acters for the year followed 
by three n characters 
for the day within the year. 
This value corresponds to 
the cdate parameter of the 
LABEL control statement. 



Yes 



Yes. The creation 
date is meaningful 
only on read opera- 
tions; on write opera* 
tions, the current 
date is always used. 



48-53 



Expiration date 



o 
*> 

CO 
Ol 

»u 
o 

o 



The file is considered 
expired when today's date 
is equal to or later than 
the date given in this field. 
When this condition is 
satisfied, the remainder 
of the volume may be over- 
written. Thus, to be effec- 
tive on multifile volumes, 
the expiration date of a file 
must be less than or equal 
to the expiration date of all 
preceding files on the 
volume. The expiration 
date is written in the same 
format as the creation date. 



Current date 



Checked if 
write attempted 



o 

*k 
co 
en 

*> 
o 

o 

o 



Character 
Position 



Field Name 



Length 
(in characters) 



Contents 

It corresponds to the rdate 
parameter of the LABEL 
control statement. 



Default 



Checked on 
Read 



54 



Accessibility 
(fa) 



An a character which in- 
dicates the restrictions, 
if any, on who may have 
access to the information 
in this file. A blank means 
unlimited access. If fa is A, 
only the owner of the 
NOS written tape 
can access the file. If fa is 
any other character, all 
future accesses to the tape 
must specify this character 
as the fa parameter. 



Blank (un- 
limited 
access) 



Yes, if a 
NOS 
written tape 









File accessibility is not 
checked for system origin 
jobs. 






55-60 


Block count 


6 


Must be zeros 




No 


61-73 


System code 


13 


13 a characters identifying 
the operating system that 
recorded this file. The 
tape is considered to have 
been written under NOS 
if the first 10 characters 
match the default. 


KRONOS 
2. 1-nn (nn is 
the EST ordi- 
nal of the unit 
on which the 
file was 
written) 


No 



74-80 Reserved for 

future standardi- 
zation 



Must be spaces 



No 



i 

Q 
i 

-a 



EOF! — FIRST END-OF-FILE LABEL 

The end-of-file label is the last block of every file. It is the system end-of-informa- 
tion for the file. A single tape mark precedes EOFl. A double tape mark written 
after the EOFl label marks the end of a multifile set. 



EOF 


1 


file identifier (fi) 


file identifier (fi) 


fi 


set identification 


file section , 
number Tspono) 


secno 


file 
sequence number 


generation number 


gvn 


gvn 


creation date 


expiration 
date 


expiration 
date 


fa 


block count 


system code 


system code 


reserved 
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CO 


Character 
Position 


Field Name 


Length 
(in characters) 


Contents 


o 
o 

> 


1-3 


Label 
identifier 


3 


Must be EOF 




4 


Label number 


1 


Must be 1 




5-54 


Same as corre- 
sponding fields 
in HDR1 
(optional) 


50 


Same as the corres 
fields in HDR1 




55-60 


Block count 


6 


Six n characters si 



Default 



Checked on 
Read 

Yes 



Yes 

Same as 
HDR1 



Yes 



61-80 Same as corre- 

sponding fields 
in HDR1 
(optional) 



20 



the number of data blocks 
between this label and the 
preceding HDR label group. 
This total does not include 
labels or tape marks. 

Same as corresponding 
fields in HDR1 



Same as HDR1 



i 

Q 
i 

CO 



EOV1 — FIRST END-OF-VOLUME LABEL 

The end- of- volume label is required only if the physical end-of-tape reflector is en- 
countered before an EOF1 label is written or if a multifile set is continued on another 
volume. EOV1 is preceded by a single tape mark and followed by a double tape mark. 



EOV 


1 


file identifier (fi) 


file identifier (fi) 


fi 


set identification 


file section 
number (Secno) 


secno 


seauence number generation number 1 evn 


gvn 


creation date 


expiration 
date 


expiation | fft block CQUnt 


system code 


system code | reserved 
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o 

£>. 

CO 

en 

o 
o 



Character 
Position 

1-3 

4 
5-54 

55-60 



Field Name 

Label 
identifier 

Label number 

Same as the 
corresponding 
fields in HDRl 
(optional) 

Block count 



Length 
(in characters) 



1 
50 



Contents 



Default 



61-80 



Same as the 
corresponding 
fields in HDRl 
(optional) 



20 



Must be EOV 



Must be 1 



Same as the corresponding 
fields in HDRl 



Six n characters specifying 
the number of data blocks 
between this label and the 
preceding HDR label group. 
This total does not include 
labels or tape marks. 

Same as the corresponding 
fields in HDRl 



Checked on 
Read 

Yes 

Yes 

Same as HDRl 



Yes 



Same as HDRl 



O 



These labels define four possible file configurations. 

• A single file on a single volume 

• A single file on two or more volumes 

• Two or more files on a single volume 

• Two or more files on two or more volumes 

Figures 1-G-l through l-G-7 illustrate the use of ANSI labels in these configurations. 
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Figure 1-G-l. ANSI Labels: Single File, Single Volume 



HDRI 




EOFI 



* = TAPE MARK 
- = USER DATA 



Figure l-G-2. ANSI Labels: Single File, Multivolume 



60435400 A 
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FILE B 



*= TAPE MARK 
- = USER DATA 



Figure l-G-3 ANSI Labels: Multifile, Single Volume 
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VOLI 


HDRI 


* 


FILEA 




FILE C 



* = TAPE MARK 
- = USER DATA 



Figure l-G-4. ANSI Labels: Multifile, Multivolume 
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VOLI 


HDRI 


* 


FILE A - 




(A) 












NOTE: 

THE LETTERS (A) AND (B) IN 
PARENTHESES INDICATE TO WHICH 
FILES THE LABELS ABOVE THEM BELONG. 



*=TAPE MARK 
-=USER DATA 



Figure l-G-5. ANSI Labels: End-of-File, End- of- Volume Coincidence 
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NOTE: 

THE LETTERS (A) AND (B) IN PARENTHESES 
INDICATE TO WHICH FILES THE LABELS ABOVE 
THEM BELONG. 



* = TAPE MARK 
- = USER DATA 



Figure l-G-6. ANSI Labels: End-of-File, End- of- Volume Coincidence 
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FILE A 




-* = TAPE MARK 
- = USER DATA 



Figure l-G-7. ANSI Labels: End-of-File, End- of- Volume Coincidence 
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OPTIONAL LABELS 

Six types of optional labels are allowed. They are additional file header (HDR2-9), 
end-of-file (EOF2-9), end-of-volume (EOV2-9), user volume (UVLa), header (UHLa), 
and trailer (UTLa) labels. 

HDR2-9 — ADDITIONAL FILE HEADER LABELS 

HDR2-9 labels may immediately follow HDR1. Their format is: 

Default 
Written 



Character 
Pos ition 


Field Name 


(in 


Length 
characters) 


Contents 


1-3 


Label 
identifier 




3 


HDR 


4 


Label number 




1 


2-9 


5-80 






76 





HDR 



2-9 



Only the label identifier and the label number are checked on read. 

EOF2-9 — ADDITIONAL END-OF-FILE LABELS 

EOF2-9 labels may immediately follow EOF1. Their format is: 



Character 
Position 


Field Name 


(in 


Length 
characters) 


Contents 


1-3 


Label 
identifier 




3 


EOF 


4 


Label number 




1 


2-9 


5-80 






76 





Default 
Written 

EOF 



2-9 



Only the label identifier and the label number are checked on read. 

EOV2-9 — ADDITIONAL END-OF-VOLUME LABELS 

EOV2-9 labels may immediately follow EOV1. Their format is: 



Character 
Position 


Field Name 


(in 


Length 
characters) 


Contents 


1-3 


Label 
identifier 




3 


EOV 


4 


Label number 




1 


2-9 


5-80 






76 





Default 
Written 

EOV 



2-9 



Only the label identifier and the label number are checked on read. 
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Refer to section 3, volume 2 for a description of the use of EOV2 labels in conjunction with 
CLOSER, REWIND, and UNLOAD macros. 

USER LABELS 

User labels may immediately follow their associated system labels. Thus, user volume 
( labels (UVLa) may follow VOL1, user header labels (UHLa) may follow the last HDRn 
label, and user trailer labels (UTLa) may follow the last EOVn or EOFn label. Their 
format is: 



Character 
Position 

1-3 



Field Name 

Label 
identifier 



Length 
(in characters) 



Contents 



UVL, UHL, or UTL 



Default 
Written 

UVL, UHL, 
or UTL 



I 



5-80 



Label number 



User option 



76 



Must be 1, 2, 3, 4, 
etc. , consecutively 
for UVL labels. For 
other labels, any a 
character. 

Any a characters. 



Only the label identifier and the label number are checked on read. The system checks 
the number of user labels of a label type; a maximum of 64 is allowed. 
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GLOSSARY 



H 



BLOCK 



The information between interrecord gaps on an NOS 
tape format. This term is not defined for operating 
system mass storage devices. In CDC CYBER Record 
Manager, there are four block types for sequential 
files. Blocking is the grouping of user records for 
efficiency in transfer between memory and storage 
devices. 



BOI 



CDC CYBER RECORD MANAGER 



CIO 



CONTROL STATEMENT RECORD 



DIRECT ACCESS FILE 



EOF 



B eginning- of- information. 

A software product supported under NOS that allows 
a variety of record types, blocking types, and file 
organizations to be created and read. The execution 
time input/output of COBOL 4, COBOL 5, FORTRAN 
Extended 4, Sort/Merge 4, ALGOL 4, BASIC, and the 
DMS-170 products is implemented through CDC 
CYBER Record Manager. The system input/output 
of NOS is not implemented through CDC CYBER 
Record Manager. All CDC CYBER Record Manager 
file processing requests ultimately pass through the 
operating system input/output routines. COMPASS 
programs can use either CDC CYBER Record Manager 
or NOS input /output (CIO). 

Combined input/output performs input/output for NOS. 
The data formats (physical and logical) do not neces- 
sarily match the data formats used by CDC CYBER 
Record Manager. 

The first, and possibly only, record on an INPUT 
file or a deferred batch job file consisting of statement 
images that start with a job statement and end with 
the first EOR, EOF, or EOI. 

A permanent file that can be attached to the user's 
job. All changes to this file are made on the file 
itself rather than a working copy of the file (refer 
to indirect access file). 

End- of- file is a boundary within a sequential file, 
but not necessarily the end of a file that can be 
referenced by name. The actual end of a named file 
is defined by EOI. On a PRU device, a zero length 
PRU with level designator of 17 indicates EOF. On 
tapes other than SI, I, or X format, EOF is repre- 
sented by a tape mark (refer to section 10). 
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EOI 
EOR 



EMPTY RECORD 
FET 

FILE 



In CDG CYBER Record Manager, a zero length PRU 
with a level designator of 17 and a tape mark on a tape 
in S or L format is a partition boundary. For W type 
records, the partition boundary is marked by a W 
control word with the end of partition flag set. CDC 
CYBER Record Manager divides files into partitions; 
therefore, an NOS multifile file is a multipartition 
file when discussing PRU devices. 

End- of- information. 

End-of-record is the terminator of a logical record. 
On a PRU device, a short PRU or a zero length PRU 
with a level designator of indicates EOR. On tapes 
that are not PRU devices, an interrecord gap indi- 
cates EOR. Only CDC CYBER Record Manager S 
type terminator is equivalent to the NOS EOR boundary. 

Refer to zero length PRU. 

The file environment table defines the current status 
and properties of a file that is being used by a job. 
CDC CYBER Record Manager uses an FIT to describe 
its files and interfaces to CIO through the FET. 

Set of information that begins at BOI.and ends at EOI 
and that is referred to by a logical file name. This 
is the only definition of a file in CDC CYBER Record 
Manager and the languages that use CDC CYBER 
Record Manager. In NOS, a file is also defined as 
that portion of a file terminated by EOF; thus, a 
multifile file can exist. Generally, when an NOS 
control statement has a parameter that is a file name, 
that parameter refers to the BOI and EOI definition. 
When an NOS control statement has a parameter that 
specifies the number of files, that parameter uses the 
EOF definition. 



FILE TYPES 



FIT 



INDIRECT ACCESS FILE 



In CDC CYBER Record Manager, one of five file 
organizations. In NOS, file types has several mean- 
ings depending upon context (refer to section 2 for a 
description of NOS file types). 

File information table is required by CDC CYBER 
Record Manager for each file to be accessed. Fields 
in the table describe such items as file structure and 
record type. All CDC CYBER Record Manager 
input/output is based on the content of the table. CDC 
CYBER Record Manager provides the interface 
between the FIT and FET. NOS uses the FET for 
input /output to a device. 

A permanent file that is accessed only by making a 
working copy of the file (GET or OLD control state- 
ments). It is created or altered by saving or substi- 
tuting the contents of an existing working file 
(REPLACE or SAVE control statements). 
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INTERRECORD GAP 
LEVEL DESIGNATOR 



LINE 

LOCAL FILE 
LOGICAL RECORD 



PARTITION 



PRIMARY FILE 



PROCEDURE FILE 



PRU 



PRU DEVICE 



Physical spaces between data blocks on tape. 

The level designator is an octal number in the termi- 
nating marker of a PRU, ranging from 00 to 17g. A 
level 17 in an empty PRU designates an EOF in NOS 
and an end of partition in CDC CYBER Record Manag- 
er. A level in a short PRU designates an EOR in 
NOS. A level 1 in a short PRU in NOS designates an 
EOR and that the record came from an interactive 
terminal. A level 16 in a short PRU in NOS desig- 
nates an EOR on a checkpoint file. 

Refer to zero byte terminator. 

A file that is currently associated with a job. 

A logical record on mass storage is terminated by 
an EOR; on tape, it is terminated by the conditions 
described in section 10 for individual tape formats. 
Often, a logical record contains more than one CDC 
CYBER Record Manager record. Since CDC CYBER 
Record Manager defines a line as a logical record, 
an NOS logical record may contain several record 
manager logical records. 

A CDC CYBER Record Manager file with sequential 
and word addressable organizations. It represents 
a file division that can contain records and sections. 
A file may have one or more partitions. 

The physical representation of a partition on an S or 
L tape is a tape mark. On a PRU device, a file with 
record type other than W has partitions indicated by 
a zero length record with a level designator of 17. 
For W type records, a partition is not equivalent to 
any designator recognized by NOS. 

Any working file created with the OLD, PRIMARY, 
or NEW control statement. 

A file containing control language and control 
statements. 

Physical record unit. The amount of information 
transmitted by a single physical operation of a speci- 
fied device. A PRU for mass storage devices is 64 
central memory words in length. A PRU for a binary 
tape in SI, I, or X format is 512 central memory words 
long, and a PRU for a coded tape in SI, I, or X format 
is 128 central memory words long. It may not be full 
of user data (short PRU) or may contain no user data 
(empty or zero length PRU). The physical length of 
the PRU is as previously defined. 

Any mass storage device or tape in SI, I, or X for- 
mat, where these records are written in PRUs. 
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RANDOM FILE 



RECORD 



RECORD SEPARATOR 
RECORD TYPE 

SEQUENCE NUMBERS 

SEQUENTIAL FILE 



SHORT PRU 

W TYPE RECORD 



WORKING FILE 



A file with an address associated with each record 
such that a particular record in the file can be 
accessed by address. To be accessed randomly, a 
file must reside on mass storage. NOS recognizes 
a file as being random only when the random bit is 
set in the FET. CDC CYBER Record Manager 
recognizes four types of random access files: word 
addressable, indexed sequential, direct access, and 
actual key organizations. All CDC CYBER Record 
Manager organizations are sequential files when 
processed by NOS* 

A unit of information, which is interchangeable with 
logical records in NOS. 

In CDC CYBER Record Manager and its language 
processors, a unit of information produced by a 
single write request. In FORTRAN Extended, a 
formatted write produces zero byte terminated 
records, and an unformatted write produces W type 
records. An operating system record is not the 
same as a CDC CYBER Record Manager type record 
unless the CDC CYBER Record Manager record 
type is declared to be S. 

In NOS, another name for an EOR. 

May have one of several meanings, depending upon its 
context. In CDC CYBER Record Manager, there are 
seven record types defined by the RT field in the FIT. 

Line numbers at the beginning of each line of a file. 
If a file uses sequence numbers, zero byte terminated 
records are implied. 

A file in which records are accessed in the logical 
order in which they occur. Any file can be accessed 
sequentially. Sequential files must be accessed 
sequentially because no key or address is associated 
with each record in the files. All CDC CYBER Record 
Manager files are considered sequential files by NOS. 

A PRU that does not contain the maximum number of 
character data allowed for that device. 

A CDC CYBER Record Manager record type in which 
user data is preceded by a system- supplied control 
word. FORTRAN Extended unformatted writes and 
Sort/Merge use W type records as default record 
types. EOF and partition boundaries are not equiva- 
lent on files with this type of record. 

A file that is currently associated with a job and is 
temporary in nature. That is, all working files 
cease to exist once they are returned to the system 
(either specifically or at job termination). 
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ZERO BYTE TERMINATOR 



ZERO LENGTH PRU /RECORD 



6/7/8/9 MULTIPUNCH 
6/7/9 MULTIPUNCH 
7/8/9 MULTIPUNCH 



The 12 bits of zero in the low order position of a 
central memory word are used to terminate a line of 
coded information to be output to a line printer or to 
represent cards input through a card reader. Files 
with names INPUT and OUTPUT have such termina- 
tors while in storage. Any file to be displayed at a 
terminal must also have such terminators for each 
line to be displayed correctly. A record with such a 
terminator in CDC CYBER Record Manager is a 
zero-byte record (Z type record). 

The COPYSBF, COPYCR, L072, LIST80, RESEQ, 
ROUTE, and SUBMIT control statements require 
files whose lines are zero-byte records. A record 
(marked by EOR) in NOS may contain one or several 
zero-byte records. 

In display code, two colons create 12 bits of zeros. 
If two consecutive colons occur in a file that contains 
zero-byte records, they may be stored in the lower 
order portion of a word and create a zero-byte 
record. 

Files created at a terminal under AUTO and TEXT 
commands or by using Text Editor contain zero-byte 
terminated records. 

A PRU that contains no user data. If the level desig- 
nator is zero, NOS calls it an EOR. CDC CYBER 
Record Manager calls it an EOR only for S type 
records. If the level designator is 17, NOS calls it 
an EOF and CDC CYBER Record Manager calls it 
end- of- partition. For a PRU device, COPYCF, 
COPYSBF, COPYX, and COPYBF copy to this 
boundary. Since a file can be subdivided into files by 
EOFs, the term multifile file arises in NOS. 

Signifies an EOI on a card deck. 

Signifies an EOF on a card deck. 

Signifies an EOR on a card deck. 
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INDEX 



AB 1-6-9 

*A directive l-C-4 

A mode 1-8-3 

Abnormal termination codes 1-B-l 

Abort job 1-5-6; 1-10-3 

Absolute binary cards l-F-3,4, 5 

ACCESS 1-4-3 

Access date 1-8-14 

Access limits 1-6-2 

Access word 1-6-8 

Accessibility, tape l-G-3,7 

Accessing files 1-2-9 

Accessing direct access files 1-8-6 

Access mode 1-8-2,6,7 

Accessing tape files 1-10-13 

Accessing unlabeled tapes 1-10-11 

Account block SRU limit 1-6-18, 19 

ACCOUNT statement 1-6-2 

Accounting information 1-3-7 

* ADD directive l-C-4, 8 

Address out of range 1-3-13; 1-6-12 

Address registers 1-13-2 

♦AFTER directive l-C-4, 6 

Aging jobs 1-3-13 

ALGOL statement 1-11-3 

Alternate checkpoint dumps 1-10-17 

Alternate system 1-1-2 

Alternate user information 1-8-6,7 

Alternate user number 1-2-7; 1-8-2 

ANSI labels 1-10-1, 9, 16; 1-G-l 

ANSI labels 

End-of-file, end -of- volume 

coincidence l-G-16, 17, 18 
Multifile, multi volume 1-G-l 5 
Multifile, single volume l-G-14 
Single file, multivolume l-G-13 
Single file, single volume l-G-13 

Answerback identifier 1-6-9 

APPEND mode 1-8-3 

APPEND statement 1-8-5 

Appending information to a file 1-8-5 

ARE 1-4-2 

ARG= entry point 1-5-3 

Arithmetic error 1-4-2 

Arithmetic operators 1-4-1,2 

ASCII/display code conversion 1-10-2; 
l-A-6,7 

ASCII mode 1-4-12 

ASCII statement 1-4-12 

ASCII terminals l-F-6 

Assembler languages 1-1-4 



ASSIGN statement 1-7-2; 1-10-11 

Assigning a file 1-10-11, 13 

Assigning a pack 1-6-15 

Assigning a tape unit 1-6-15; 1-10-17 

Assigning equipment 1-10-11, 14, 17 

Assigning nonallocatable devices 1-6-10 

Assigning resources 1-6-15 

ATTACH statement 1-8-6 

Auto eject mode l-F-5 

Automatic permission 1-8-2 

Auxiliary device requests 1-8-13 

Auxiliary devices 1-2-8; 1-6-9; 1-8-4 

Auxiliary devices, creating files on 1-6-10 

AW 1-6-10 



B format 1-10-27 

*B directive l-C-3,4 

Backspacing a file 1-7-3 

Backup system 1-2-8 

BASIC statement 1-11-6 

BASIC subsystem 1-4-3 

Batch jobs, submitting 1-6-21 

Batch origin type 1-3-7 

BATCH subsystem 1-4-3 

BCD code l-F-2 

BCO 1-4-2 

BCOT 1-3-7 

-BEFORE directive l-C-3,4, 7 

Beginning of information 1-2-2 

Binary cards l-F-3,4, 5 

Binary data 1-9-2 

Binary punch output 1-2-4 

Binary record management 1-C-l 

Binary records 1-9-4, 5; 1-F-l 

BKSP statement 1-7-3 

Blank labeling a tape 1-10-12 

BLANK statement 1-10-12 

Block count l-G-7, 9, 11 

Block, defined 1-10-1 

Blocked data format 1-2-2; 1-10-27 

BOI 1-2-1,2 

Boolean operators 1-4-2 

*BUILD directive l-C-4, 9 



CALL statement 1-4-5 
Card deck 1-2-2 
Card file structure 1-2-2 
Card format 1-2-2; l-F-2 
Cards, binary l-F-3,4, 5 
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Cards, coded l-F-2 

Cards, punched l-F-4, 5 

Cards, read l-F-2 

Carriage control characters l-A-8; l-F-5 

Carriage return delay 1-6-9 

CATALOG statement 1-7-4 

Catalog, user 1-8-2,8 

Category, file 1-8-2,13 

CATLIST statement 1-8-8 

CB parameter 1-7-2; 1-12-3 

CC 1-6-9 

CCCCCCC 1-10-18 

CCCCCCO 1-12-1 

CEJ/MEJ option 1-1-1 

Central exhange jump /monitor exchange 

jump 1-1-1 
Central library directory 1-5-6 
Central memory, defined 1-1-1 
Central memory dumps 1-9-1,2; 1-12-1; 

1-13-1 
Central memory field length 1-5-5 
Central memory resident, defined 1-1-2 
Central memory time slice 1-3-13 
Central processor abort 1-3-14 
Central processor priority, maximum 

1-6-9 
Central processor time 1-3-13; 1-5-5; 

1-6-20 
Central processor time, maximum 

1-6-9*20 
Central processor unit, defined 1-1-1 
CHANGE statement 1-8-10 
Character conversion l-F-4, 6 
Character count 1-10-2 
Character set conversion 1-10-2 
Character sets 1-A-l; l-F-6 
Charge number 1-6-2,10 
CHARGE statement 1-3-7; 1-6-2 
Checkpoint dumps 1-10-13; 1-12-1 
Checkpoint files 1-10-2; 1-12-1 
Checkpoint /restart 1-12-1 
Checksum l-F-3,5 
CIO error messages 1-B-l 
CK parameter 1-7-2; 1-12-3 
CKP statement 1-12-1 
CLEAR statement 1-7-7 
CM data error 1-3-14 
CM, defined 1-1-1; 1-6-9 
CM dumps 1-13-1 
CMC input error 1-3-14; 1-6-12 
CM, maximum 1-6-9 
CM time slice 1-3-13 
CMR, defined 1-1-2 
CN 1-6-10 

COBOL statement 1-11-8 
COBOL5 statement 1-11-11 
Code, Hollerith l-F-2 
Display l-F-2 
Internal BCD l-F-2 



Coded cards l-F-2, 4 

Coded format l-F-4 

Coded records l-F-2 

^COMMENT directive l-C-4, 9 

COMMENT statement 1-6-3 

^'comment statement 1-6-3 

COMMON statement 1-7-7 

Communication area 1-B-l 

Compare error l-F-4 

COMPASS source deck 1-3-2 

COMPILE file 1-14-2,6 

Compiler languages 1-1-4 

Completion of a job 1-3-15 

Condition codes 1-3-13, 14 

Configurations, PPU 1-1-3 

Configurations, tape file l-G-12 

Constants 1-4-1 

Continuation lines 1-10-10 

Control language 1-4-1 

Control language functions 1-4-8 

Control language statements 1-4-4 

Control point area 1-3-7 

Control point dayfile 1-3-16 

Control points, defined 1-1-2 

Control statement format 1-5-1; 1-11-2; 

l-C-2 
Control statement input buffer 1-5-6 
Control statement processing 1-3-8; 1-5-1 
Control statement processing flow 1-5-6,7 
Control statements 1-5-1 

Checkpoint/restart 1-12-1 

File management 1-7-1 

Job control 1-6-1 

Load /dump central memory utility 
1-9-1 

Loader control 1-5-1 

Permanent file 1-8-1 

Product set 1-11-1 

System utility 1-14-1 

Tape management 1-10-1 
Conversion, character set 1-10-2 
Conversion mode 1-5-6; 1-10-2; l-F-2, 3 
Conversion processes l-F-2 
CONVERT statement 1-7-7 
*COPY directive l-C-4, 10 
COPY statement 1-7-8 
COPYBF statement 1-7-9 
COPYBR statement 1-7-10 
COPYCF statement 1-7-10 
COPYCR statement 1-7-11 
COPYEI statement 1-7-12 
COPYSBF statement 1-7-12 
COPYX statement 1-7-13 
Correction line images 1-9-3 
Correspondence code terminals l-F-6 
CP directive 1-6-9 
CPE 1-4-3 
CPU, defined 1-1-1 
CPU error exit 1-3-13 
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CPU hardware error exit mode 1-6-12 

CPU priority 1-6-20 

CPU program error exit mode 1-6-12 

CPU programs 1-1-4 

CPU time 1-6-6 

CPU time limit 1-6-9 

CPUMTR 1-1-2 

Creating 

Direct access file 1-8-11 

Indirect access file 1-8-15, 16 

Labeled tape 1-10-13 

Library file 1-2-5; 1-C-l 

Tape files 1-10-1, 13 

Unlabeled tape 1-10-11 
Creation date 1-8-14; 1-10-2; l-G-6 
Cross reference, system symbols 1-14-10 
CS 1-6-9 

CSET statement 1-4-12 
CT option 1-8-2 
CTIME statement 1-5-6; 1-6-3 
Current time 1-6-18 



*D directive l-C-4 

Data channels 1-1-3 

Data conversion mode l-F-2 

Data format 1-10-3,21 

Data input l-F-6 

Data output l-F-6 

*DATA directive l-C-4. 9 

Dayfile messages 1-B-l 

DAYFILE statement 1-6-3 

DB 1-6-9 

DC 1-7-31 

DDP 1-1-3 

Deadlock 1-6-13 

DEBUG mode 1-6-7 

Debugging aids 1-13-1 

Deck structure 1-3-1 

Deferred batch jobs 1-6-9 

DEFINE statement 1-8-11 

^DELETE directive l-C-4, 7 

Density, tape 1-10-3 

Device, auxiliary 1-2-8 

Device number 1-8-10, 14 

Device, permanent file 1-2-8 

Device residence 1-2-8 

Device statistics 1-E-l 

Device type 1-4-9; 1-7-2; 1-8-4 

DF 1-6-9 

Diagnostic messages 1-B-l 

Direct access files 1-2-5, 7 

Accessing 1-8-6 

Block sizes 1-2-7; 1-E-l 

Changing parameters 1-8-10 

Defining 1-8-11 

Interlock 1-8-6 

Maximum size in PRUs 1-E-l 



Purging 1-8-14,15 

Space 1-8-4 
Directives 

Escape character 1-6-21 

MODIFY 1-14-2 

OPLEDIT 1-14-4 

UPDATE 1-14-6 
Disable hardware exit mode 1-6-12 
Disable program exit mode 1-6-12 
Dismounting packs 1-6-15 
Dismounting tapes 1-6-15 
Display code l-F-2 
Display code dumps 1-9-2 
DISPLAY statement 1-4-6 
DISPOSE statement 1-7-14 
Disposition of job output 1-6-21 
Distributive data path 1-1-3 
DMD statement 1-9-2 
DMP statement 1-9-1; 1-13-1 
DMP subroutine 1-13-2 
DOCMENT statement 1-7-15 
DS 1-6-10 

Dump from a terminal 1-9-2 
Dumping central memory 1-9-1,2; 1-13-1 
Dumps 1-13-1 
Duplicate lines in dump 1-9-1; 1-13-1 



E format 1-10-26 

E mode 1-8-3 

EBCDIC /display code conversion 1-10-2; 

l-A-6,7 
EC 1-6-10; 1-7-32 
EC directive 1-6-24 
ECS 1-1-3 

ECS data storage /retrieval 1-1-2 
ECS files 1-2-2 
ECS flag register operation parity error 

1-3-13; 1-6-12 
EDIT statement 1-14-1 
Editing an OPL-formatted file 1-14-2 
EF 1-4-3 
EIO 1-4-3 
EIOT 1-3-6,7 
E mode 1-8-3 
EM 1-4-3 
EM-M 1-13-2 
EM-N 1-13-2 
End of file 1-2-1 

B format 1-10-27 

E format 1-10-26 

F format 1-10-28 

I format 1-10-22 

S format 1-10-25 

SI format 1-10-24 

X format 1-10-24 
End of file label 1-G-l, 8, 19 
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End of information 1-2-1 

B format 1-10-27 

E format 1-10-26 

F format 1-10-28 

I format 1-10-22 

S format 1-10-25 

SI format 1-10-24 

X format 1-10-25 
End of line byte 1-F-l 
End of record 1-2-1 

B format 1-10-27 

E format 1-10-26 

F format 1-10-28 

I format 1-10-22 

S format 1-10-25 

SI format 1-10-23 

X format 1-10-24 
End of reel, defined 1-10-29 

B format 1-10-27 

E format 1-10-26 

F format 1-10-28 

I format 1-10-23 

S format 1-10-25 

SI format 1-10-24 

X format 1-10-25 
End-of-tape, defined 1-10-29 
End of tape processing 1-10-29 
End-of-tape reflector 1-G-l 
End of volume label 1-G-l, 10, 19 
Enforce ring 1-10-6 
ENQUIRE statement 1-6-4 
EOF 1-2-1,2 

EOF card 1-2-2; 1-3-1, l-F-2 
EOF directive 1-6-22 
EOF 1 label 1-G-l, 19 
EOI 1-2-1,2 

EOI card 1-2-2; 1-3-1; l-F-2 
EOR 1-2-1,2 

EOR card 1-2-2; 1-3-1; l-F-2 
EOR directive 1-6-22 
EOV1 label 1-G-l, 10 
EOV2 label 1-G-l 
EOV2-9 labels 1-G-l, 19 
Equipment /file assignment 1-10-11 
Error codes l-B-1,34 
Error conditions 1-3-13; 1-6-12, 13 
Error control 1-3-13; 1-6-7,12; 1-13-2 
Error exit address 1-3-14 
Error exit mode 1-6-11, 12 
Error flag 1-3-14; 1-5-8; 1-6-12 
Error inhibit 1-10-7 
Error messages 1-B-l 
Error processing 1-5-8; 1-6-12 
Error processing bit 1-B-l 
Escape character 1-6-21 
Evaluation of control language expressions 

1-4-4 
EVICT statement 1-7-16 



Exchange package 1-9-1; 1-13-1 

EXECUTE mode 1-8-3 

EXECUTE subsystem 1-4-3 

Exit mode 1-3-13 

Exit processing 1-5-8; 1-6-7, 12 

EXIT statement 1-3-14; 1-5-8; 1-6-7; 

1-13-2 
Expiration date l-G-6 
Export /Import origin type 1-3-6,7 
Expressions 1-4-1 
Extended core storage 1-1-2 
External data format 1-2-2; 1-10-24 
External reference 

ALGOL 4 1-11-3 

BASIC 3 1-11-6 

COBOL 1-11-8 

COBOL5 1-11-11 

FTN 1-11-17 

SORTMRG 1-11-23 



F format 1-10-28 

Family 1-2-8 

Family device 1-8-4 

Family name 1-2-8; 1-6-5,27 

FC 1-6-9; 1-7-32 

FET 1-B-l 

FET description 1-2-9 

FID 1-7-32 

Field length 1-3-8,9; 1-5-5; 1-6-17; 1-13-2 

Field length assignment 1-3-8,9; 1-5-5; 

1-6-17 
Field length control 1-3-8,9 
Field length, user defined 1-6-17 
File accessibility 1-2-9; 1-10-3 
File, block sizes 1-E-l 
File category 1-8-2 
File, checkpoint 1-12-1,2 
File, communication area 1-2-9 
File, direct access 1-2-5; 1-8-6, 11 
*FILE directive l-C-4, 5 
File environment table 1-B-l 
File function 1-4-8 
File header label 1-G-l, 4, 19 
File identifier 1-10-4; l-G-5 
File management control statements 1-7-1 
File name, new 1-8-10 
File name table 1-2-3 
File password 1-8-2 
File permission mode 1-8-2, 14 
File, private 1-8-2 
File, public 1-8-2 
File, purging 1-8-14, 15 
File, replacing 1-8-15 
File, residency 1-8-11 
File, saving 1-8-16 
File section number 1-10-8; l-G-2,5 
File sequence number 1-10-8; l-G-5 
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File function 1-4-8 

File status 1-4-8 

File status table 1-2-3 

File, structure 1-2-1 

File, types 1-2-3; 1-8-14 

Files 1-2-1 

Files, accessing 1-2-9 

Files, local 1-2-4 

Files, magnetic tape 1-10-1 

Files, maximum number attached 1-6-9 

Files, reading 1-2-9 

Files, writing 1-2-11 

First file header label l-G-4 

First end-of-file label l-G-8 

First end-of-volume label l-G-10 

First word address of memory 1-9-1 

FL 1-4-3 

FLE 1-4-3 

FM 1-7-32 

FNT entry 1-2-2,3 

Force unload 1-10-7 

Foreign data format 1-2-2; 1-10-28 

Formats for cards read l-F-2 

Formats for cards punched l-F-4 

Formats for printed data l-F-5 

FORTRAN source deck 1-3-4 

Frame count 1-10-3 

FS 1-6-9 

FST entry 1-2-3 

FTN statement 1-11-17 

FTNTS subsystem 1-4-3 

FULL duplex transmission mode 1-6-9 

Functions 1-4-2 



Generation number 1-10-4; l-G-6 

Generation version number 1-10-3; l-G-6 

GET statement 1-8-12 

gid l-C-3 

GOTO statement 1-4-4 

Group record identifier l-C-3 

GTR statement 1-7-17 

HALF duplex transmission mode 1-6-9 

Hardware components 1-1-1 

Hardware error exit mode 1-6-12; 1-13-2 

Hardware instructions 1-1-4 

HDR1 label l-G-1,4 

HDR2-9 labels l-G-19 

Header label, defined l-G-1,4 

Hollerith punch code l-F-2, 3 

Hollerith punch output 1-2-4 



I format 1-2-2; 1-10-22 
*I directive l-C-4 
IC 1-7-33 
ID 1-2-6; 1-7-33 



IF statement 1-4-7 

*IGNORE directive l-C-4, 7 

Illegal instruction 1-3-13 

Increasing the number of scheduled units 

1-6-15 
Increment registers 1-13-2 
Indefinite operand 1-3-13; 1-6-12 
Indirect access files 1-2-7; 1-8-15, 16 

Accessing 1-8-6 

Appending information 1-8-5 

Block size 1-2-7; 1-E-l 

Changing parameters 1-8-10 

Creating 1-8-15,16 

Maximum number 1-6-9 

Maximum size in PRUs 1-6-9; 1-E-l 

Purging 1-8-14 

Replacing 1-8-15 

Saving 1-8-16 
Infinite operand 1-3-12 
INFT type filps 1-2-3 
Inhibit unload 1-10-6 
Initiating ajob 1-3-6 
Input, data l-F-6 
INPUT file 1-3-12 
Input file control 1-3-12 
Input files 1-2-3 
Input queue 1-3-8, 13 
Input queue priority 1-3-8 
INPUT , writing on 1-3-12 
^INSERT directive l-C-4, 6 
Interchangeable families 1-2-8 
Interlock 1-8-6 
Internal BCD code l-F-2 
Internal data format 1-2-2; 1-10-22 
IS 1-6-9 



Job abort 1-5-6; 1-10-6 

Job completion 1-3-15 

Job control 1-3-8; 1-6-1 

Job control statement 1-3-1; 1-5-4,5 

Job control control statements 1-6-1 

Job deck 1-3-1 

JOB directive 1-6-21 

Job field length 1-3-8,9; 1-5-5; 1-6-17 

Job files 1-2-3 

Job flow 1-3-1 

Job initiation 1-3-6 

Job name 1-3-6, 7; 1-5-5, 1-6-7 

Job name format 1-3-6,7 

Job origin type 1-3-6 

Job output information 1-D-l 

Job priority 1-2-3; 1-3-8 

Job scheduling 1-2-3; 1-3-8 

Job statement format 1-5-4 

Job step 1-3-8,9,12,31; 1-5-5; 1-6-20 

Job structure 1-3-1 

Job subsystem 1-4-3 
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Job termination 1-3-15 
Jobs, submitting 1-6-21 



Keywords 1-5-3 
KRONREF statement 



1-14-10 



L format tapes 1-10-25 

Label, defined 1-10-1 

Label identifier l-G-3, 5, 9, 11, 20 

Label number l-G-3, 5, 9, 11, 20 

Standard level 1-10-5; l-G-3 
LABEL statement 1-10-13 
Label types 1-G-l 
Labeled tape 1-10-8, 9, 13 
Labels 1-G-l 
Labels, optional 1-G-l 9 
Labels, required 1-G-l 
Last word address of memory 1-9-1 
LBC statement 1-9-2 
LDI statement 1-6-7 
Legal user 1-6-2 
LENGTH statement 1-6-8 
LFM error codes l-B-33 
LGO 1-5-1; 1-12-1 
LIBEDIT 1-C-l 
LIBEDIT directive 1 -C - 1 , 3 
LIBEDIT /LIBGEN examples 1-C-ll 
LIBEDIT statement 1-7-18; 1-C-l 
LIBGEN statement 1-7-19 
Library files • 1-2-5; 1-C-l 
Library, program 1-14-6 
Library routines 1-11-1 
Library type files 1-2-5, 14 
Library user 1-11-1 
Libraries 1-2-12 

System 1-2-12 

Program 1-2-12 

User 1-2-12; 1-11-1 

User number LIBRARY 1-2-14 
LIFT type files 1-2-5 
LIMITS statement 1-3-7; 1-6-8 
Line image data format 1-10-26 
Line numbers 1-6-22 
Line spacing l-F-5 
LIST LB statement 1-10-16 
LIST80 statement 1-7-20 
Literal input l-F-3 
Literals 1-5-2 
Load map 1-13-3 
Load /dump central memory utility control 

statements 1-9-1 
Loaders 1-5-1 
Loading binary data 1-9-2,4 
Loading octal card images 1-9-3 
Local file control statements 1-5-1 
Local file, retrieve permanent file 1-8-12 



Local file, saving 1-8-16 

Local files 1-2-4 

Location of data in core dump 1-13-4 

LOC statement 1-9-3 

LOCK statement 1-7-21 

LOFT type files 1-2-4 

Logical end of file 1-2-1 

Logical end of information 1-2-1 

Logical end of record 1-2-1 

Logical/ physical file structure 1-2-1 

Logical record 1-2-1; 1-3-1 

Long Block Stranger data format 1-10-25 

L072 statement 1-7-21 

LP 1-6-9 



M mode 1-8-3 

Magnetic tape 1-10-1 

Magnetic tape file, checkpoint 1-12-1,2 

Magnetic tape file structure 1-2-2 

Magnetic tape files, creating 1-10-1 

Magnetic tape formats 1-2-2; 1-10-21 

Blocked 1-2-2; 1-10-27 

External 1-2-2; 1-10-24 

Foreign 1-2-2; 1-10-28 

Internal 1-2-2; 1-10-22 

Line image 1-2-2; 1-10-26 

System internal 1-2-2; 1-10-23 

Long blocked stranger tape 1-2-2; 
1-10-25 

Stranger tape 1-2-2; 1-10-25 
Magnetic tape labels 1-G-l 
Magnetic tape units, maximum 1-6-9 
Magnetic tapes, access restrictions 1-6-16 
Magnetic tapes, assigning 1-6-15 
Magnetic tapes, maximum 1-6-19 
Magnetic tapes, scheduling 1-6-16 
Magnetic tapes, system management 1-6-15 
Main overlay 1-13-5 
Managing tapes and packs 1-6-15 
Mass storage device file structure 1-2-2 
Mass storage device statistics 1-E-l 
Mass storage files, size 1-8-4 
Mass storage, maximum 1-6-10 
Maximum field length 1-3-9; 1-5-5 
Maximum number of control points 1-1-2 
Maximum time 1-3-13 
Memory boundaries 1-13-1 
MEMORY macro 1-3-9 
Memory, releasing 1-3-8; 1-6-16 
Memory, requirements 

ALGOL 1-11-3 

BASIC 3 1-11-6 

COBOL 1-11-8 

FTN 1-11-17 

SORTMRG 1-11-23 
MERGE file 1-14-6 
Messages 1-B-l 
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MFL statement 1-6-11 

MFL= entry point 1-3-8 

MNE 1-4-3 

MODE statement 1-3-14; 1-6-11 

Modification date 1-8-14 

Modification decks 1-14-4 

Modification identifiers 1-14-4,5 

MODIFY statement 1-14-2 

Modify directive 1-14-2 

MODIFY mode 1-8-3 

Modify-formatted program library file 

1-14-4 
MODVAL statement 1-6-11 
MS 1-6-9 
MT 1-6-9 

Multifile reels l-G-12 
Multifile sets 1-G-l 
Multireel files l-G-12 



N mode 1-8-3 

NA option 1-8-5 

*NAME directive l-C-4, 5 

ND option 1-8-5 

Nested calls to procedure files 1-4-11 

New file name 1-8-10 

New password 1-6-14 

New permanent file name 1-8-9 

NEW statement 1-7-24 

NEWPL file 1-14-6 

NF 1-6-9 

No abort option 1-8-5 

No drop option 1-8-5 

NOEXIT statement 1-3-14; 1-5-8; 1-6-13 

1-13-2 
Noise size 1-10-1,5 
Nonallocatable device 1-6-10 
Nonallocatable devices, assigning 1-6-10 
Nonstandard labels 1-G-l 
NO PACK directive 1-6-22 
*NOREP directive l-C-4, 9 
NORERUN statement 1-6-13 
NORMAL mode 1-4-12 
NOS labeled tape 1-10-4 
NOS standard character set l-A-4 
NOS unlabeled tape 1-10-4 
NOS written tape 1-10-1; l-G-7 
NOSEQ directive 1-6-22 
NOTRANS directive 1-6-23 
NPL file 1-14-4 
NULL mode 1-8-3 
NULL subsystem 1-4-3 
NUM function 1-4-9 
Number of jobs 1-6-8, 21 



Octal card image format 1-9-3 

Octal card images, loading 1-9-3 

ODE 1-4-3 

OF 1-6-9 

OFA 1-10-5 

OFFSW statement 1-6-13 

Old password 1-6-14 

OLD statement 1-8-12 

OLD PL file 1-14-7,9 

ONEXIT statement 1-5-8; 1-6-13; 1-13-2 

ONSW statement 1-6-14 

Operand out of range 1-3-13; 1-6-12 

Operand registers 1-13-2 

Operating system format 1-5-1,2,3 

Operators 1-4-1,2 

OPL file 1-14-2 

OPL record type 1-7-5 

OPLC record type 1-7-5 

OPLD record type 1-7-5 

OPLEDIT statement 1-14-4 

Order-dependent format 1-5-3 

Order-independent format 1-5-3 

Origin type 1-3-6 

Origin type, batch 1-3-7 

Origin type, remote batch 1-3-7 

Origin type, system 1-3-6 

Origin type, time-sharing 1-3-7 

OT 1-4-3 

OUT statement 1-7-24 

Output, data l-F-6 

Output file 1-2-4 

OUTPUT file 1-2-4; 1-12-1 

Output information 1-D-l 

Overcommitment of resources 1-6-16 

OVL record type 1-7-5 

Owner identification 1-10-6, l-G-3 

Owner of a NOS written tape 1-10-1,6 

Owner of auxiliary device 1-2-8 

026 mode 1-5-6; l-F-2 

029 mode 1-5-6; l-G-3 



PA 1-6-9 

PACK directive 1-6-22 

Pack name 1-2-8; 1-8-4, 13 

PACK statement 1-7-25 

PACKNAM statement 1-8-13 

Packs, access restrictions 1-6-16 

Packs, assigning 1-6-15 

Packs, private 1-6-17 

Packs, public 1-6-17 

Packs, scheduling 1-6-15 

Packs, shareable 1-6-17 

Packs, system management 1-6-15 



60435400 C 



Index-7( 



Paper tape reader l-F-6 

Parameter field 1-5-2 

Parameters, control statement 1-5-3 

Parameters, number of characters 1-5-3 

PARITY statement 1-4-12 

PASSWOR statement 1-6-14 

Password 1-6-27; 1-8-2 

Password, changing 1-6-10 

PBC statement 1-9-4 

PEE 1-4-3 

Peripheral hardware 1-1-4 

Peripheral processor library directory 

1-5-6 
Peripheral processor units 1-1-3 
Permanent file control statements 1-8-1 
Permanent file devices 1-2-8; 1-8-4, 1-E-l 
Permanent file information 1-8-8 
Permanent file name, changing 1-8-10 
Permanent files 1-2-5 
Private 1-8-2 
Public 1-8-2 
Semiprivate 1-8-2 
Permanent file size 1-E-l 
Permanent file system 1-8-1 
Permanent file request to auxiliary device 

1-8-13 
Permanent file, used as local file 1-8-12 
Permanent files, direct access 1-2-7; 

1-8-6 
Permanent files, indirect access 1-2-7 
Permanent files, purging 1-8-14, 15 
Permission, file 1-8-2, 14 
Permission information 1-8-7 
PERMIT statement 1-8-14 
PFM error codes l-B-34 
PFM error messages 1-B-l 
PHFT type files 1-2-4 
Physical file structure 1-2-1 
Physical record unit, magnetic tape 

1-2-2; 1-10-1 
Physical record unit, mass storage 1-2-2 
Physical record units, defined 1-2-1 
PMFT type files 1-2-5 
PN 1-6-10 
PN option 1-8-4 
PP record type 1-7-5 
PPE 1-4-3 
PPU 1-1-3 

PPU record type 1-7-5 
Prefix character 1-5-1 
PRFT type files 1-2-4 
PRI 1-7-33 

PRIMARY statement 1-7-26 
Primary terminal files 1-2-6 
Print file priority 1-2-4 
Print files 1-2-4 
Printed data l-F-5 
Printer queue 1-2-4 



Priority, CPU 1-6-5 
Priority, job 1-2-3 
Priority level 1-5-5 
Priority, queue 1-3-8 
Private file 1-8-2, 13 
Private packs 1-2-8; 1-6-17 
Procedure files 1-4-1, 10 
Processing options 1-10-6 
Product set control statements 1-5-1; 
1-11-1 

ALGOL 1-11-3 

BASIC 1-11-6 

COBOL 1-11-8 

COBOL5 1-11-11 

FTN 1-11-17 

SORTMRG 1-11-23 
Product set format 1-5-1,2,3 
Program address 1-13-2 
Program address register 1-9-1 
Program call statements 1-11-2 
Program error exit mode 1-6-12; 1-13-2 
Program library 1-2-12 
Program library utility control statements 

1-14-1 
Program name field 1-5-2 
Project number 1-6-2, 10 
PRU 1-2-1 

Magnetic tape 1-2-2; 1-10-1 

Mass storage 1-2-2 

Punched statements 1-2-2 
PRU size 1-2-1; 1-E-l 
PSE 1-4-3 

Pseudo-sense switches 1-6-13,26 
PTFT type files 1-2-6 
Public file 1-8-2 
Public packs 1-2-8; 1-6-17 
*PULLMOD directives 1-14-5 
PUNCH 1-2-4 
Punch code l-F-4 
Punch file structure 1-2-2 
Punch files 1-2-4 

PUNCHB 1-2-4; 1-9-4; 1-12-1; l-F-5 
Punched card format l-F-4, 5 
PURGALL statement 1-8-14 
PURGE statement 1-8-15 
Purging files 1-8-14,15 
PX 1-6-9 
PW option 1-8-2 
P8 1-2-4; 1-12-1; l-F-5 



Queue files 1-2-3; 1-7-14 
Queue, input 1-3-13 
Queue priority 1-3-8, 13 
Queue, rollout 1-3-13 
Queued file management 1-2-6 
Queues, releasing files 1-7-14 
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R mode 1-8-3 

R option 1-8-4 

RA 1-1-2 

RA mode 1-8-3 

RA+1 1-1-2 

Random access 1-2-9 

RBR statement 1-9-4 

READ directive 1-6-23 

READ mode 1-8-3 

READAP mode 1-8-3 

Reading binary records 1-9-4 

Reading CM dumps 1-13-3 

Reading files 1-2-9. 

Reading statements l-F-2 

READMD mode 1-8-3 

Record 1-2-1 

Record logical 1-2-1 

Record management 1-C-l 

Record manager 1-11-1 

Record prefix 1-9-4 

Record type 1-7-5 

Reference address 1-1-2 ; 1-13-2 

Reference record identifier l-C-3 

Reflector, end-of-tape 1-G-l 

Reformatting directive 1-6-22 

REL type record 1-7-5 

Relational operators 1-4-2 

Releasing memory 1-3-8 

Releasing output files 1-3-15, 16 

Remote batch origin type 1-3-6, 7 

Removable auxiliary devices, maximum, 

file residency 1-6-9; 1-8-4 
Remove file 1-8-14,15 
RENAME statement 1-7-26 
^RENAME directive l-C-4, 10 
REP 1-7-33 

REPLACE statement 1-8-15 
^REPLACE directive l-C-4, 10 
Replacing files 1-8-15 
REQUEST statement 1-7-27; 1-10-17 
Required tape labels 1-G-l 
RERUN statement 1-6-14 
Rerun status 1-6-14 
Rescheduling a job 1-6-18 
RESEQ statement 1-7-29 
Reservation blocks 1-E-l 
Residency, file 1-2-8; 1-8-9,10 
RESOURC statement 1-6-15 
Resource types 1-6-15 
Resource utilization 1-6-2 
RESTART statement 1-12-2 
Restarting a job 1-12-1,2 
Retention cycle 1-10-8 
Retention date 1-10-8 
RETURN statement 1-7-29 
Returning a pack 1-6-17 
Returning a tape file 1-6-17 
REWIND directive 1-6-24 



*REWIND directive l-C-4, 5 

REWIND statement 1-7-30 

Rewrite in place 1-2-11 

RFL= entry point 1-3-8 

RFL statement 1-3-8; 1-6-17 

rid l-C-3 

RM mode 1-8-3 

RO 1-6-9 

ROFT files 1-2-3 

Rolling out a job 1-3-13 

Rollout control 1-3-13 

Rollout files 1-2-3; 1-3-13 

Rollout queue 1-3-13 

ROLLOUT statement 1-6-18 

Rollout time period 1-3-13 

ROUTE statement 1-3-6; 1-7-31 

RP 1-6-9 

RTIME statement 1-5-6; 1-6-18 

Rubout characters 1-6-9 

Running field length 1-3-8; 1-5-5 

Rl 1-4-3 

R2 1-4-3 

R3 1-4-3 

S format 1-10-25 
S option 1-8-4 
Sample job 1-D-l 
SAVE statement 1-8-16 
Saving a file 1-8-16 
SC 1-7-33 
*SC directive 1-5-1 
Scheduling jobs 1-2-3; 1-3-8 
Scheduling packs 1-6-16 
Scheduling resources 1-6-15 
Scheduling tape units 1-6-15 
Scheduling units 1-6-15 
Scratch files 1-2-4 
SDM= entry point 1-5-3 
SECDED network 1-3-14 
Section number l-G-5 
Security control 1-3-15 
Security count 1-6-27 
Semiprivate files 1-8-2 
Sense switch 1-6-13,26 
Separators 1-5-2 
SEQ directive 1-6-22 
Sequence number l-G-5 
Sequential access 1-2-9 
Set identification l-G-5 
Set identifier 1-10-8 
SET statement 1-4-6 
SETASL statement 1-6-18 
SETCORE statement 1-6-19 
SETID statement 1-7-34 
SETJSL statement 1-6-19 
SETPR statement 1-6-20 
SETRFL macro 1-3-9 
SETTL macro 1-3-12 
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SETTL statement 1-3-12; 1-6-20 

Sharable packs 1-6-17 

SI format 1-10-23 

Single-error correction double-error 

detection network 1-3-14 
SKIPEI statement 1-7-35 
SKIPF statement 1-7-35 
SKIPFB statement 1-7-35 
SKIPR statement 1-7-36 
SL 1-6-10 

SORT statement 1-7-36 . 
SORTMRG statement 1-11-23 
SOURCE file 1-14-2,7 
Space for direct access file 1-8-4 
Special control statements 1-5-6 
Special files 1-2-4 
SRE 1-4-3 
SRU 1-3-7 

SRU limit 1-3-12; 1-4-3; 1-6-10, 18 
SS 1-4-3 
ST 1-7-33 

STAGE statement 1-7-38 
Standard labels 1-G-l 
Statement label field 1-5-1 
Status information 1 -B - 1 
STIME statement 1-5-6; 1-6-20 
Stranger data format 1-10-25 
Structure of files 1-2-1 
SUBMIT statement 1-3-6, 7; 1-6-21 
Submitting jobs 1-3-6; 1-6-21 
Subroutine 1-13-6 
Subsystem .1-4-3 
SUI statement 1-6-25 
SUMMARY statement 1-6-25 
SWITCH statement 1-6-26 
SYFT type files 1-2-6 
symbolic names 1-4-2 
SYO 1-4-3 
SYOT 1-3-6 
System code l-G-7 
System control statements 1-5-1 
System default library 1-11-2 
System description 1-1-1 
System files 1-2-6 
System internal data format 1-10-23 
System job name 1-3-6 
System library 1-2-12 
SYSTEM macro 1-13-2 
System monitor 1-1-2 
System origin type 1-3-6 
System origin privileges 1-6-9 
System priorities 1-3-8 
System resource units 1-3-7 
System sequence number 1-3-6 
System software 1-1-4 
System utility control statements 1-14-1 



Tape file configurations l-G-12 

Tape file structure 1-2-2 

Tape formats 1-2-2 

Tape labels 1-G-l 

Tape management 1-10-1 

Tape mark 1-10-1; l-G-8, 10 

Tape units 

Assigning 1-6-15 

Dismounting 1-6-17 

Scheduling 1-6-15 

System management 1-6-15 
TAPEn 1-9-4,5 

Tapes, access restrictions 1-6-15 
TC 1-6-9 

TDUMP statement 1-7-39 
TEFT file 1-2-3 

Terminal character conversion l-F-6 
Terminal data input l-F-6 
Terminal parity 1-6-9 
Terminal type 1-6-9 
Termination 1-3-15 
Terminators 1-5-2 
TEXT record type 1-7-5 
TID 1-2-6; 1-7-33 
Time limit 1-3-10; 1-6-20 
Time limit control 1-3-10; 1-6-20 
Time limit error 1-5-8 
Time of day 1-6-18 
Time-sharing character set 1-A-l 
Time-sharing commands 1-4-12 
Time-sharing origin type 1-3-6 
Timed /event rollout file 1-2-3 
TKE 1-4-3 
TL 1-6-9 
TLE 1-4-3 
TRANACT 1-4-3 
TRANS directive 1-6-22 
Transaction functions 1-6-10 
Translate control statements 1-5-6 
Transmission mode 1-6-9 
Transparent mode 1-6-22,23 
TT 1-6-9 

TTY character conversion l-F-6 
TXO 1-4-3 
TXOT 1-3-6,7 
-type directive l-C-4, 5 



UHLa labels 1-G-l, 20 
ULIB record type 1-7-5 
UN 1-7-33 
UN option 1-8-2 
Unlabeled tape 1-10-13, 
Unload, force 1-10-7 
Unload, inhibit 1-10-6 
UNLOAD statement 1-7-40 
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UNLOCK statement 1-7-40 
UPDATE statement 1-14-6 
Update-formatted program library file 

1-14=^6 
Update to modify conversion 1-14-9 
UP MOD statement 1-14-9 
USECPU statement 1-6-26 
User catalog 1-8-2,8 
User header label 1-G-l, 20 
User index 1-3-7; 1-6-25 
User labels l-G-20 
User libraries 1-2-12; 1-11-1 
User number 1-2-7; 1-3-7; 1-6-27 
User number, alternate 1-8-2 
User number library 1-2-14 
User permission 1-8-3,7 
User programs 1-1-4 
USER statement 1-6-27 
User's control point dayfile 1-6-3,4 
User trailer label 1-G-l, 20 
User validation 1-6-27 
User volume label 1-G-l, 20 
UT La labels 1-G-l, 20 
UVLa labels 1-G-l, 20 



VERIFY statement 1-7-41 
VFYLIB statement 1-7-42 
Volume accessibility 1-10-9 
Volume, defined 1-10-1 
Volume header label 1-G-l, 2 
Volume serial number 1-10-1,9 
VOL1 1-G-l, 2, 3 
VSN l-G-3 
VSN statement 1-10-18 



W mode 1-8-3 
WBR statement 1-9-5 
Working files 1-2-4, 6 
WRITE mode 1-8-3 
WRITEF statement 1-7-42 
WRITER statement 1-7-42 
Writing files 1-2-11 



Validation 1-3-7 
Validation information 



1-6-8,9, 10 



X format 1-10-24 



6/7/8/9 statement 1-2-2; l-F-2 
6/7/9 statement 1-2-2; l-F-2 
7/8/9 statement 1-2-2; l-F-2 
80-column binary punch output 1-2-4 
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